MCP Creator MCP

🚀 MCP-Creator-MCP

A meta-MCP server that democratizes MCP server creation through AI-guided workflows and intelligent templates. Transform vague ideas into production-ready MCP servers with minimal cognitive overhead and maximum structural elegance.

🚀 Quick Start

Prerequisites

• Python 3.10 or higher
• uv package manager
• Claude Desktop (for MCP integration)

Installation

# Clone and set up the project
git clone https://github.com/angrysky56/mcp-creator-mcp.git
cd mcp-creator-mcp

# Create and activate virtual environment
uv venv --python 3.12 --seed
source .venv/bin/activate

# Install dependencies
uv add -e .

# Configure environment
cp .env.example .env
# Edit .env with your API keys (see Configuration section)

Basic Usage

Option 1: As an MCP Server (Recommended)

1. Configure Claude Desktop:

   # Copy the example config
   cp example_mcp_config.json ~/path/to/claude_desktop_config.json
   # Edit paths and API keys as needed
   

2. Start using in Claude Desktop:
   • Restart Claude Desktop
   • Use tools like create_mcp_server, list_templates, get_ai_guidance

Option 2: Standalone Interface

# Launch the Gradio interface
uv run gradio_interface.py

# Or use the CLI
uv run mcp-creator-gui

✨ Features

• 🤖 AI-Guided Creation: Get intelligent suggestions and best practices tailored to your use case
• 📚 Template Library: Curated collection of proven MCP server patterns
• 🔄 Workflow Engine: Save and reuse creation workflows for consistent results
• 🎨 Gradio Interface: User-friendly web interface for visual server management
• 🔧 Multi-Language Support: Python, Gradio, and expanding language ecosystem
• 📊 Built-in Monitoring: Server health checks and operational visibility
• 🛡️ Best Practices: Automated validation and security recommendations

📦 Installation

Prerequisites

• Python 3.10 or higher
• uv package manager
• Claude Desktop (for MCP integration)

Steps

# Clone and set up the project
git clone https://github.com/angrysky56/mcp-creator-mcp.git
cd mcp-creator-mcp

# Create and activate virtual environment
uv venv --python 3.12 --seed
source .venv/bin/activate

# Install dependencies
uv add -e .

# Configure environment
cp .env.example .env
# Edit .env with your API keys (see Configuration section)

💻 Usage Examples

Basic Usage

Option 1: As an MCP Server (Recommended)

1. Configure Claude Desktop:

   # Copy the example config
   cp example_mcp_config.json ~/path/to/claude_desktop_config.json
   # Edit paths and API keys as needed
   

2. Start using in Claude Desktop:
   • Restart Claude Desktop
   • Use tools like create_mcp_server, list_templates, get_ai_guidance

Option 2: Standalone Interface

# Launch the Gradio interface
uv run gradio_interface.py

# Or use the CLI
uv run mcp-creator-gui

Advanced Usage

Creating Your First MCP Server

# In Claude Desktop, ask:
"Create an MCP server called 'weather_helper' that provides weather data and forecasts"

# Or use the tool directly:
create_mcp_server(
    name="weather_helper",
    description="Provides weather data and forecasts",
    language="python",
    template_type="basic",
    features=["tools", "resources"]
)

Getting AI Guidance

# Ask for specific guidance:
get_ai_guidance(
    topic="security",
    server_type="database"
)

# Or access guidance resources:
# Use resource: mcp-creator://guidance/sampling

Managing Templates

# List available templates
list_templates()

# Filter by language
list_templates(language="python")

📚 Documentation

Configuration

Environment Variables

Create a .env file with your settings:

# AI Model Providers (at least one required for AI guidance)
ANTHROPIC_API_KEY=your_anthropic_key_here
OPENAI_API_KEY=your_openai_key_here
OLLAMA_BASE_URL=http://localhost:11434

# MCP Creator Settings
DEFAULT_OUTPUT_DIR=./mcp_servers
LOG_LEVEL=INFO

# Gradio Interface
GRADIO_SERVER_PORT=7860
GRADIO_SHARE=false

Claude Desktop Integration

1. Edit your Claude Desktop config (usually at ~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-creator": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-creator-mcp",
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your_key_here"
      }
    }
  }
}

2. Restart Claude Desktop

Architecture

Core Principles

• Simplicity: Each component has a single, clear responsibility
• Predictability: Consistent patterns reduce cognitive load
• Extensibility: Modular design enables easy customization
• Reliability: Comprehensive error handling and graceful degradation

Component Overview

├── src/mcp_creator/
│   ├── core/              # Core server functionality
│   │   ├── config.py      # Clean configuration management
│   │   ├── template_manager.py  # Template system
│   │   └── server_generator.py # Server creation engine
│   ├── workflows/         # Workflow management
│   ├── ai_guidance/       # AI assistance system
│   └── utils/             # Shared utilities
├── templates/             # Template library
├── ai_guidance/           # Guidance content
└── mcp_servers/          # Generated servers (default)

Template System

Available Templates

• Python Basic: Clean, well-structured foundation
• Python with Resources: Database and API integration patterns
• Python with Sampling: AI-enhanced server capabilities
• Gradio Interface: Interactive UI with MCP integration

Creating Custom Templates

Templates use Jinja2 with clean abstractions:

# Template structure
templates/languages/{language}/{template_name}/
├── metadata.json          # Template configuration
├── template.py.j2        # Main template file
└── README.md.j2          # Documentation template

Workflow System

Saving Workflows

save_workflow(
    name="Database MCP Server",
    description="Complete database integration workflow",
    steps=[
        {
            "id": "collect_requirements",
            "type": "input",
            "config": {"fields": ["db_type", "connection_string"]}
        },
        {
            "id": "security_review",
            "type": "ai_guidance",
            "config": {"topic": "database_security"}
        },
        {
            "id": "generate_server",
            "type": "generation",
            "config": {"template": "python:database"}
        }
    ]
)

Development

Project Structure

The codebase follows clean architecture principles:

• Separation of Concerns: Each module has a single responsibility
• Dependency Injection: Components are loosely coupled
• Error Boundaries: Graceful failure handling throughout
• Type Safety: Comprehensive type hints and validation

Adding New Templates

1. Create template directory: templates/languages/{lang}/{name}/
2. Add metadata.json with template configuration
3. Create template.{ext}.j2 with Jinja2 template
4. Test with the template manager

Contributing

1. Fork the repository
2. Create a feature branch with descriptive name
3. Follow the existing code patterns and style
4. Add tests for new functionality
5. Submit a pull request with clear description

Security & Best Practices

Built-in Protections

• Input Validation: All user inputs are validated and sanitized
• Process Management: Proper cleanup prevents resource leaks
• Error Handling: Graceful failure with helpful messages
• Logging: Comprehensive operational visibility

Recommended Practices

• Use environment variables for sensitive data
• Implement rate limiting for production deployments
• Regular security audits of generated servers
• Monitor server performance and resource usage

Troubleshooting

Common Issues

Server won't start:

# Check dependencies
uv add -e .

# Verify configuration
cat .env

# Check logs
tail -f logs/mcp-creator.log

Claude Desktop integration:

# Verify config file syntax
python -m json.tool claude_desktop_config.json

# Check server connectivity
python main.py --test

Template errors:

# List available templates
uv run python -c "from src.mcp_creator import TemplateManager; print(TemplateManager().list_templates())"

Monitoring & Operations

Health Checks

The server provides built-in health monitoring:

• Resource usage tracking
• Error rate monitoring
• Performance metrics
• Template validation

Logging

All operations are logged to stderr (MCP compliance):

# View logs in real-time
python main.py 2>&1 | tee mcp-creator.log

What's Next?

• Multi-language expansion: TypeScript, Go, Rust templates
• Cloud deployment: Integration with major cloud platforms
• Collaboration features: Team workflows and template sharing
• Advanced AI: Enhanced code generation and optimization
• Marketplace: Community template and workflow ecosystem

🔧 Technical Details

Core Principles

• Simplicity: Each component has a single, clear responsibility
• Predictability: Consistent patterns reduce cognitive load
• Extensibility: Modular design enables easy customization
• Reliability: Comprehensive error handling and graceful degradation

Component Overview

├── src/mcp_creator/
│   ├── core/              # Core server functionality
│   │   ├── config.py      # Clean configuration management
│   │   ├── template_manager.py  # Template system
│   │   └── server_generator.py # Server creation engine
│   ├── workflows/         # Workflow management
│   ├── ai_guidance/       # AI assistance system
│   └── utils/             # Shared utilities
├── templates/             # Template library
├── ai_guidance/           # Guidance content
└── mcp_servers/          # Generated servers (default)

📄 License

MIT License - see LICENSE for details.