mcp-server-builderlisted
Install: claude install-skill DROOdotFOO/agent-skills
# MCP Server Builder
Generate Model Context Protocol servers from OpenAPI specifications. Supports
Python (FastMCP) and TypeScript targets.
## What You Get
- Working MCP server directory scaffolded from an OpenAPI spec
- Typed tool definitions, auth wrappers, confirmation gates, and test stubs
## Workflow
1. **Parse** -- Read the OpenAPI spec (JSON or YAML), extract paths, operations,
schemas, and auth requirements.
2. **Generate** -- Map each operation to an MCP tool definition with typed input
schemas. Apply naming conventions (verb_noun, snake_case).
3. **Secure** -- Add auth wrappers, host allowlists, confirmation gates for
destructive operations, and structured error payloads.
4. **Validate** -- Run the manifest through lint checks: duplicate names, missing
descriptions, invalid schemas, naming hygiene.
5. **Test** -- Unit tests for schema transforms, contract tests for manifest
snapshots, integration tests against a staging API.
## Quality Gates (before publishing)
- [ ] Every tool has a non-empty description
- [ ] No duplicate tool names
- [ ] All destructive operations require confirmation input
- [ ] Secrets sourced from env vars only (none in schemas or defaults)
- [ ] Host allowlist is explicit (no wildcards unless justified)
- [ ] Manifest passes strict validation (`validation.md`)
- [ ] Unit + contract tests pass
- [ ] Integration test against at least one live endpoint
## Top Pitfalls
| Mistake | Fix |
| --- | --- |
| Leaking API keys in