MCP Builder Skill#

Bootstraps new Model Context Protocol servers from natural language descriptions.

Instructions#

When the user requests an MCP server or tool:

1. Identify the core functionality from the description
2. Determine the appropriate transport (stdio for CLI, SSE for web)
3. Scaffold a TypeScript or Python MCP server using the official SDK
4. Generate tool definitions from API schemas or describe them manually
5. Include a test harness with example invocations
6. Provide configuration for Claude Code, Cursor, and OpenCode

Features#

• TypeScript (recommended) and Python scaffolding
• Auto-generates tool definitions from API schemas (OpenAPI, JSON Schema)
• STDIO and SSE transport support
• Built-in error handling and validation
• Test harness with mock LLM calls
• Claude Code / Cursor / OpenCode configuration snippets

Architecture#

text

mcp-server/
├── src/
│   ├── index.ts          # Server entry point
│   ├── tools.ts          # Tool definitions
│   └── handlers.ts       # Request handlers
├── package.json
├── tsconfig.json
├── README.md
└── test/
    └── harness.ts        # Test harness

Output Format#

1. Project scaffold (all files)
2. Tool definitions with descriptions and input schemas
3. Configuration snippet for Claude Code's mcpServers config
4. Test invocation example

Example#

text

User: "Build an MCP server for our internal issue tracker with create, list, and close operations"

→ Generate: TypeScript MCP server with 3 tools, JSON Schema for each, test harness, Claude Code config

Dependencies#

Requires: Node.js 18+, TypeScript, @modelcontextprotocol/sdk