What is Mcp Cookie Cutter

mcp-cookie-cutter is a cookiecutter template designed for creating new MCP (Model Control Protocol) servers. It provides a structured way to generate a fully functional MCP server with standard input/output and Server-Sent Events (SSE) support, exemplified by a simple echo service.

Use cases

Use cases for mcp-cookie-cutter include developing echo servers for testing, creating custom MCP servers for specific applications, and building real-time data streaming services that utilize SSE for efficient data delivery.

How to use

To use mcp-cookie-cutter, ensure you have Python 3.10 or higher, the uv package installer, and Cookie Cutter installed. You can create a new MCP server by either cloning the template from GitHub or using a local copy. Follow the prompts to configure your project, including project name, slug, description, author details, and server port.

Key features

Key features of mcp-cookie-cutter include the ability to generate a fully functional MCP server, support for both stdio and SSE, and a straightforward setup process that guides users through project configuration and dependency installation.

Where to use

mcp-cookie-cutter can be used in various fields where Model Control Protocol servers are applicable, such as real-time data processing, IoT applications, and any system requiring efficient communication between clients and servers.

MCP Server Cookie Cutter Template

A cookie cutter template for creating new MCP (Model Context Protocol) servers. This template generates a fully functional MCP server with unified transport handling (stdio and SSE) and MCP Inspector compatibility, demonstrated through a simple echo service.

Features

• Unified transport handling (stdio and SSE in a single implementation)
• Full MCP Inspector compatibility
• Example echo tool implementation
• Proper absolute imports throughout
• Development environment setup
• Comprehensive documentation templates

Prerequisites

1. Python 3.11 or higher

   python --version  # Should be 3.11 or higher
   

2. uv (Fast Python package installer)

   # Install uv if you don't have it
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. Cookie Cutter

   uv pip install cookiecutter
   

Creating a New MCP Server

You can create a new MCP server either directly from GitHub or from a local copy of this template.

Option 1: Directly from GitHub

cookiecutter gh:codingthefuturewithai/mcp-cookie-cutter

Option 2: From Local Copy

1. Clone this template:

   git clone https://github.com/codingthefuturewithai/mcp-cookie-cutter
   

2. Create a project using the local template:

   cookiecutter path/to/mcp-cookie-cutter
   

Template Configuration

You’ll be asked for:

• project_name: Human-readable name (e.g., “My MCP Server”)
• project_slug: Python package name (e.g., “my_mcp_server”)
• description: Short description of your project
• author_name: Your name
• author_email: Your email
• server_port: Port for SSE server (default: 3001)

Generated Project Structure

my_mcp_server/              # Your project directory
├── my_mcp_server/          # Python package directory
│   ├── __init__.py
│   ├── client/             # Client implementations
│   │   ├── __init__.py
│   │   └── app.py         # Test client implementation
│   ├── server/            # Server implementation
│   │   ├── __init__.py
│   │   └── app.py        # Unified MCP server implementation
│   └── tools/             # Tool implementations
│       ├── __init__.py
│       └── echo.py       # Example tool implementation
├── pyproject.toml         # Project configuration
├── README.md             # Project documentation template
└── DEVELOPMENT.md        # Development guide template

Next Steps

Once your project is generated:

1. Review and customize the README.md template
2. Follow DEVELOPMENT.md for:
   • Setting up the development environment
   • Installing dependencies
   • Running the server
   • Testing with the example client
   • Using MCP Inspector
3. Start adding your own tools in the tools/ directory

License

This template is licensed under the MIT License - see the LICENSE file for details.