https://github.com/codingthefuturewithai/mcp-cookie-cutter
A cookiecutter template for creating MCP (Model Control Protocol) servers
https://github.com/codingthefuturewithai/mcp-cookie-cutter
Last synced: about 2 months ago
JSON representation
A cookiecutter template for creating MCP (Model Control Protocol) servers
- Host: GitHub
- URL: https://github.com/codingthefuturewithai/mcp-cookie-cutter
- Owner: codingthefuturewithai
- Created: 2025-03-06T00:03:54.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-08-23T02:17:40.000Z (2 months ago)
- Last Synced: 2025-08-23T04:22:36.210Z (2 months ago)
- Language: Python
- Size: 701 KB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **mcp-cookie-cutter** - A cookiecutter template for creating MCP (Model Control Protocol) servers `python` `mcp` `server` `pip install git+https://github.com/codingthefuturewithai/mcp-cookie-cutter` (🤖 AI/ML)
- awesome-mcp-servers - **mcp-cookie-cutter** - A cookiecutter template for creating MCP (Model Control Protocol) servers `python` `mcp` `server` `pip install git+https://github.com/codingthefuturewithai/mcp-cookie-cutter` (🤖 AI/ML)
README
# 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
```bash
python --version # Should be 3.11 or higher
```
2. uv (Fast Python package installer)
```bash
# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh
```
3. Cookie Cutter
```bash
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
```bash
cookiecutter gh:codingthefuturewithai/mcp-cookie-cutter
```
### Option 2: From Local Copy
1. Clone this template:
```bash
git clone https://github.com/codingthefuturewithai/mcp-cookie-cutter
```
2. Create a project using the local template:
```bash
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.