Files
2025-11-29 18:16:51 +08:00
..
2025-11-29 18:16:51 +08:00
2025-11-29 18:16:51 +08:00
2025-11-29 18:16:51 +08:00
2025-11-29 18:16:51 +08:00
2025-11-29 18:16:51 +08:00
2025-11-29 18:16:51 +08:00
2025-11-29 18:16:51 +08:00
2025-11-29 18:16:51 +08:00

MCP Server Creator Skill

Automated tool for creating production-ready Model Context Protocol (MCP) servers with TypeScript or Python SDKs.

What This Skill Does

The MCP Server Creator skill streamlines the entire process of building MCP servers by:

  1. Gathering requirements through interactive questions about your server's purpose
  2. Selecting the right SDK (TypeScript, Python, Java, Kotlin, or C#)
  3. Generating project structure with proper dependencies and build configuration
  4. Creating server implementation with tools, resources, and prompts
  5. Configuring Claude Desktop integration with proper paths and environment
  6. Providing testing guidance with MCP Inspector and validation steps

When to Use

Use this skill when you want to:

  • Connect Claude to your data sources (databases, APIs, files)
  • Expose custom tools for AI to call
  • Build workflow automation servers
  • Create enterprise integrations
  • Learn MCP development patterns

Trigger Phrases

  • "create an MCP server for [purpose]"
  • "build a Model Context Protocol server"
  • "set up MCP integration with [data source]"
  • "help me create a server for Claude Desktop"
  • "scaffold an MCP server"

What Gets Generated

Project Structure

mcp-server-name/
├── src/
│   └── index.ts (or main.py)
├── build/ (TypeScript only)
├── package.json / pyproject.toml
├── tsconfig.json (TypeScript only)
├── .env.example
├── .gitignore
└── README.md

Key Features

  • Full TypeScript or Python server implementation
  • Proper SDK integration with error handling
  • Tool definitions with Zod schemas or type hints
  • Resource and prompt handlers (if needed)
  • Claude Desktop configuration
  • Environment variable management
  • Security best practices (.gitignore, input validation)
  • Comprehensive documentation
  • Testing instructions with MCP Inspector

Example Usage

Simple Tool Server

You: "Create an MCP server that can search my local documents"

Skill generates:

  • File search tool with glob patterns
  • Content search tool using grep
  • Resource handlers for file contents
  • Claude Desktop configuration
  • Security validations (path traversal prevention)

Database Integration

You: "Build an MCP server to query my PostgreSQL database"

Skill generates:

  • Database query tool with SQL validation
  • Schema inspection tools
  • Connection pooling setup
  • Environment variable configuration
  • Read-only query enforcement

API Wrapper

You: "Create a server that wraps the GitHub API"

Skill generates:

  • GitHub API client setup
  • Tools for common operations (search, issues, PRs)
  • Authentication configuration
  • Rate limiting handling
  • Response formatting for AI consumption

Supported Languages

Language SDK Best For
TypeScript @modelcontextprotocol/sdk Web APIs, JS ecosystem
Python mcp[cli] (FastMCP) Data processing, ML
Java Spring AI MCP Enterprise Java apps
Kotlin Kotlin SDK Android/JVM apps
C# ModelContextProtocol NuGet Windows/Azure apps

Common Patterns Included

The skill includes templates and guidance for:

  • Database Integration: PostgreSQL, MySQL, MongoDB
  • API Wrappers: REST APIs, GraphQL
  • File System Access: Secure file operations
  • Search Integration: Elasticsearch, vector search
  • Workflow Automation: CI/CD, deployments
  • Notification Systems: Email, Slack, SMS
  • Data Processing: ETL, analytics pipelines
  • Authentication: Token validation, permissions

Testing Your Server

The skill provides three testing approaches:

  1. MCP Inspector (recommended first)

    npx @modelcontextprotocol/inspector node build/index.js
    
    • Browser-based testing interface
    • Validates schemas and responses
    • No Claude Desktop required
  2. Claude Desktop Integration

    • Add to claude_desktop_config.json
    • Restart Claude Desktop
    • Test with natural language
  3. Custom Client

    • Build your own MCP client
    • Use in other AI applications

Files Included

Templates

  • typescript-server.ts.template - Full TypeScript server template
  • python-server.py.template - Full Python server template
  • package.json.template - npm configuration
  • tsconfig.json.template - TypeScript configuration

Data Files

  • common-patterns.yaml - 8 common server patterns with dependencies
  • tool-examples.yaml - Example tool definitions for common use cases

Security Features

Every generated server includes:

  • Environment variable management (never commit secrets)
  • Input validation with schemas
  • Proper error handling (don't leak internals)
  • .gitignore configuration
  • Logging best practices (stderr only for STDIO)
  • Path traversal prevention (file servers)
  • SQL injection prevention (database servers)

Next Steps After Generation

  1. Review generated code and customize tool implementations
  2. Add your API keys/credentials to .env
  3. Build the project (npm run build for TypeScript)
  4. Test with MCP Inspector
  5. Add to Claude Desktop configuration
  6. Test with natural language queries
  7. Iterate and enhance based on usage

Troubleshooting

The skill includes debugging guidance for:

  • Server not detected in Claude Desktop
  • Tools not appearing
  • Connection timeouts
  • Build errors
  • STDIO logging issues
  • Configuration syntax errors

Check ~/Library/Logs/Claude/mcp*.log for detailed error messages.

Learn More


Created by: Connor Version: 0.1.0 License: MIT