🤖 MCP Server Creation Tool

A tool that automatically scaffolds new MCP servers from scratch — creates project structure, virtual environment, and installs all dependencies with a single command.

New to MCP? Read WHAT_IS_MCP.md first.

How it works

Simply call the create_mcp_server tool and it will automatically:

• Create a project directory
• Install uv package manager if not present
• Initialize a uv project with virtual environment
• Install required dependencies (mcp, httpx)
• Generate main.py with a basic MCP server template
• Generate README.md with connection instructions

Requirements

• Python 3.10+
• macOS or Linux

Getting Started

1. Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh

Restart your terminal after installation.

2. Set up the project

uv init mcp-server
cd mcp-server
uv venv
source .venv/bin/activate
uv add "mcp[cli]" httpx

3. Add your server logic

Copy the code from mcp-server-creation.py into a new main.py:

touch main.py

4. Run the server

uv run main.py

Connecting to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

Restart Claude Desktop after saving.

Connecting to Cursor AI

1. Open Cursor → Preferences → Cursor Settings
2. Go to MCP
3. Click Add new global MCP server
4. Use the same JSON config as above

Connecting to VS Code (Continue extension)

1. Install the Continue extension
2. Edit ~/.continue/config.yaml:

mcpServers:
  - name: mcp-server
    command: uv
    args:
      - "--directory"
      - "/ABSOLUTE/PATH/TO/YOUR/mcp-server"
      - "run"
      - "main.py"

Troubleshooting

• Server not picked up — verify the absolute path in config is correct
• uv not found — restart terminal after installation
• Connection error — check Claude Desktop or Cursor logs for details