MCP Server Creator

What is MCP Server Creator about?

MCP Server Creator enables developers to define new MCP server configurations programmatically or via CLI, add custom tools and resources, and instantly produce fully functional Python server code.

How to use MCP Server Creator?

1. Installation – pip install mcp-server-creator (or use uvx mcp-server-creator).
2. CLI – run uvx mcp-server-creator or python -m mcp_server_creator to launch the interactive server.
3. Programmatic API – import functions such as create_server, add_tool, add_resource, generate_server_code, and save_server to build servers within your own scripts.
4. Execution – the generated Python file can be run directly as a FastMCP server.

Key features of MCP Server Creator

• Dynamic Server Creation – instantiate new MCP servers at runtime.
• Tool Builder – define tools with parameters, return types, sync/async implementations, and automatic import handling.
• Resource Manager – attach static data or templated dynamic resources with custom MIME types.
• Code Generation – output ready‑to‑run Python source for any configured server.
• File Export – save generated code to a .py file in one step.
• Built‑in Example Templates – includes a ready‑made Weather Service demo.

Use cases of MCP Server Creator

• Rapid prototyping of domain‑specific APIs (e.g., weather, finance, CRM).
• Building internal tool‑kits where each tool is exposed as an MCP endpoint.
• Automated generation of multiple micro‑services from a shared configuration.
• Educational environments for teaching MCP/FastMCP concepts.
• Continuous integration pipelines that generate and test server code on the fly.

FAQ from the MCP Server Creator

Q: Do I need FastMCP installed separately? A: FastMCP is a dependency; installing the package pulls the required version (>=0.1.0).

Q: Can I create async tools? A: Yes, set is_async=True when calling add_tool and provide an async implementation.

Q: How do I persist servers between sessions? A: Use save_server to write the generated code to a file, then import or run that file later.

Q: Is there a way to list all in‑memory servers? A: Call list_servers() to retrieve the identifiers of all configured servers.

Q: Can I run the creator itself as an MCP server? A: Absolutely – it can be registered in Claude Desktop or any MCP client using the standard server configuration format.

MCP Server Creator 🏗️

A powerful Model Context Protocol (MCP) server that creates other MCP servers! This meta-server provides tools for dynamically generating FastMCP server configurations and Python code.

🚀 Quick Start

Install with pip

pip install mcp-server-creator

Run with uvx (recommended)

uvx mcp-server-creator

Run as a module

python -m mcp_server_creator

Features

• Dynamic Server Creation: Create new MCP server configurations on the fly
• Tool Builder: Add custom tools with parameters, return types, and implementations
• Resource Manager: Add static and dynamic resources with template support
• Code Generation: Generate complete, runnable Python code for your servers
• File Export: Save generated servers directly to Python files
• Example Templates: Built-in example server to demonstrate capabilities

Usage

As an MCP Server

The MCP Server Creator is itself an MCP server that can be used with Claude Desktop or any MCP client.

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-server-creator": {
      "command": "uvx",
      "args": ["mcp-server-creator"]
    }
  }
}

Programmatic Usage

from mcp_server_creator import create_server, add_tool, generate_server_code

# Create a new server configuration
result = create_server(
    name="My API Server",
    description="A custom API integration server",
    version="1.0.0"
)

# Add a tool
add_tool(
    server_id="my_api_server",
    tool_name="fetch_data",
    description="Fetch data from the API",
    parameters=[{"name": "endpoint", "type": "str"}],
    return_type="dict",
    implementation='return {"data": f"Fetched from {endpoint}"}'
)

# Generate the code
code = generate_server_code("my_api_server")
print(code)

Available Tools

Server Management

• create_server: Create a new MCP server configuration
• list_servers: List all server configurations in memory
• get_server_details: Get detailed information about a specific server

Tool Management

• add_tool: Add a tool to an existing server
  • Supports both sync and async tools
  • Custom parameter definitions with types and defaults
  • Automatic import management

Resource Management

• add_resource: Add a resource to an existing server
  • Static resources for fixed data
  • Dynamic resource templates with parameters
  • Custom MIME types

Code Generation

• generate_server_code: Generate complete Python code for a server
• save_server: Save generated server code to a file
• create_example_server: Create a complete example Weather Service

Example: Creating a Weather Service

import asyncio
from mcp_server_creator import create_server, add_tool, add_resource, save_server

async def create_weather_service():
    # Create the server
    create_server(
        name="Weather Service",
        description="Get weather information",
        version="1.0.0"
    )
    
    # Add a weather tool
    add_tool(
        server_id="weather_service",
        tool_name="get_weather",
        description="Get current weather for a city",
        parameters=[
            {"name": "city", "type": "str"},
            {"name": "units", "type": "str", "default": '"celsius"'}
        ],
        return_type="dict",
        is_async=True,
        implementation='''
    # Your weather API logic here
    return {
        "city": city,
        "temperature": 20,
        "units": units,
        "condition": "sunny"
    }'''
    )
    
    # Add a resource
    add_resource(
        server_id="weather_service",
        uri="weather://{city}/current",
        name="Current Weather",
        description="Get current weather data",
        is_template=True,
        implementation='return {"city": city, "weather": "sunny"}'
    )
    
    # Save to file
    await save_server("weather_service", "weather_service.py")

# Run the creation
asyncio.run(create_weather_service())

Development

Setup

git clone https://github.com/GongRzhe/mcp-server-creator.git
cd mcp-server-creator
pip install -e .

Testing

python test_mcp_creator.py

Requirements

• Python 3.8+
• FastMCP >= 0.1.0

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

GongRzhe - gongrzhe@gmail.com

Links

• GitHub Repository
• PyPI Package
• FastMCP Documentation
• Model Context Protocol