mcp-server-creator
MCP Server Creator
Overview
This skill automates the creation of Model Context Protocol (MCP) servers—the standardized way to connect AI applications to external data sources, tools, and workflows.
Key Capabilities:
- Interactive requirements gathering and language selection
- Project scaffolding with SDK integration (TypeScript/Python)
- Server implementation with tools, resources, and prompts
- Claude Desktop configuration generation
- Testing workflow with MCP Inspector
When to Use This Skill
Trigger Phrases:
- "create an MCP server for [purpose]"
- "build a Model Context Protocol server"
- "set up MCP integration with [data source]"
- "generate MCP server to expose [tools/data]"
Use Cases:
- Exposing custom data sources to AI applications
- Creating tools for AI models to call
- Building enterprise integrations for Claude
NOT for:
- Consuming existing MCP servers (this creates new ones)
- Non-AI integrations (use REST APIs instead)
- Simple file operations (use built-in tools)
Response Style
- Interactive: Ask clarifying questions about purpose and capabilities
- Educational: Explain MCP concepts and best practices
- Language-aware: Support TypeScript and Python SDKs
- Production-ready: Generate complete, tested configurations
Quick Decision Matrix
| User Request | Action | Reference |
|---|---|---|
| "create MCP server" | Full workflow | Start at Phase 1 |
| "TypeScript MCP setup" | Skip to Phase 2 | workflow/phase-2-structure.md |
| "add tools to MCP server" | Implementation | workflow/phase-3-implementation.md |
| "configure Claude Desktop" | Integration | workflow/phase-5-integration.md |
| "test MCP server" | Validation | workflow/phase-6-testing.md |
Workflow Overview
Phase 1: Discovery & Language Selection
Understand server purpose, target AI app, and choose SDK.
→ Details: workflow/phase-1-discovery.md
Phase 2: Project Structure Generation
Create project with dependencies and configuration.
→ Details: workflow/phase-2-structure.md
Phase 3: Server Implementation
Generate core server code with tools/resources/prompts.
→ Details: workflow/phase-3-implementation.md
Phase 4: Environment & Security
Configure secrets and security best practices.
→ Details: workflow/phase-4-security.md
Phase 5: Claude Desktop Integration
Generate configuration for immediate use.
→ Details: workflow/phase-5-integration.md
Phase 6: Testing & Validation
Verify with MCP Inspector and Claude Desktop.
→ Details: workflow/phase-6-testing.md
Phase 7: Documentation & Handoff
Provide README and next steps.
→ Details: workflow/phase-7-documentation.md
Important Reminders
- STDIO = No stdout logging - Use console.error or stderr only
- Build before test - TypeScript requires
npm run build - Absolute paths only - Claude Desktop config needs full paths
- Complete restart required - Quit Claude Desktop entirely (Cmd+Q)
- Schemas matter - AI uses descriptions to decide when to call tools
- Security first - Never commit secrets, validate all inputs
- Test incrementally - MCP Inspector before Claude integration
Limitations
- Only TypeScript and Python SDKs fully supported
- HTTP transport requires additional security setup
- Claude Desktop must be restarted for config changes
- Cannot modify existing MCP servers (creates new ones only)
Reference Materials
| Resource | Purpose |
|---|---|
workflow/*.md |
Detailed phase instructions |
reference/capabilities.md |
Tools, resources, prompts deep-dive |
reference/troubleshooting.md |
Common issues and debugging |
reference/language-guides/*.md |
TypeScript and Python best practices |
Success Criteria
- Project structure created with dependencies
- Server implements requested capabilities
- All tools have proper schemas and descriptions
- Logging configured correctly (no stdout for STDIO)
- Environment variables configured securely
- Claude Desktop config generated with absolute paths
- MCP Inspector testing passes
- Server appears in Claude Desktop after restart
More from cskiro/claudex
bulletproof-react-auditor
Use PROACTIVELY when users ask about React project structure, Bulletproof React patterns, or need architecture guidance. Covers structure setup, codebase auditing, anti-pattern detection, and feature-based migration planning. Triggers on "bulletproof react", "React structure help", "organize React app", or "audit my architecture".
10codebase-auditor
Use PROACTIVELY when auditing code quality, running security scans, assessing technical debt, reviewing code for production readiness, setting up CI quality gates, or tracking DORA metrics. Analyzes codebases against OWASP Top 10, SOLID principles, Testing Trophy, and 2024-25 SDLC standards. Supports incremental audits for large codebases. Not for runtime profiling or real-time monitoring.
3skill-creator
Use PROACTIVELY when creating new Claude Code skills from scratch. Automated generation tool following Claudex marketplace standards with intelligent templates, pattern detection, and quality validation. Supports guided creation, quick start templates, clone-and-modify, and validation-only modes. Not for modifying existing skills or non-skill Claude Code configurations.
2sub-agent-creator
Use PROACTIVELY when creating specialized Claude Code sub-agents for task delegation. Automates agent creation following Anthropic's official patterns with proper frontmatter, tool configuration, and system prompts. Generates domain-specific agents, proactive auto-triggering agents, and security-sensitive agents with limited tools. Not for modifying existing agents or general prompt engineering.
2accessibility-audit
Use PROACTIVELY when user asks for accessibility review, a11y audit, WCAG compliance check, screen reader testing, keyboard navigation validation, or color contrast analysis. Audits React/TypeScript applications for WCAG 2.2 Level AA compliance with risk-based severity scoring. Includes MUI framework awareness to avoid false positives. Not for runtime accessibility testing in production, automated remediation, or non-React frameworks.
2structured-outputs-advisor
Use PROACTIVELY when users need guaranteed schema compliance or validated tool inputs from Anthropic's structured outputs feature. Expert advisor for choosing between JSON outputs (data extraction/formatting) and strict tool use (agentic workflows). Analyzes requirements, explains trade-offs, and delegates to specialized implementation skills. Not for simple text responses or unstructured outputs.
2