MCP Cookiecutter - Generate MCP Servers with Ease

Features

Everything you need to build MCP servers quickly and efficiently

Implemented

🚀

Quick Setup

Generate a complete MCP server project structure in seconds with pre-configured templates.

Go Node.js Java Python

🔧

Multiple Languages

Support for Go, Node.js, Java, and Python (available). Choose your preferred language and get started immediately.

Stdio REST, WebSocket

🔗

Flexible Transports

Stdio, REST and WebSocket (available) transport methods for your server.

Implemented

✅

Built-in Testing

Test your MCP server's resources, tools, capabilities, and initialization directly from the CLI.

Implemented

📦

Ready to Deploy

Generated projects include Docker configurations and deployment scripts for easy hosting.

Implemented

🎯

Best Practices

Templates follow MCP best practices and include example implementations for common use cases.

Implemented

🔌

Extensible

Easy to extend with custom templates and configurations to match your specific needs.

Getting Started

Get up and running in minutes

Version: v0.4.1 (latest release)

Install

Clone the repository and build the CLI:

                    git clone https://github.com/aawadall/mcpcli.git
                    cd mcpcli
                    go build -o mcpcli ./cmd/mcpcli
                

Generate

Create your MCP server project (non-interactive or interactive):

                    # Non-interactive (all options specified)
                    ./mcpcli generate my-server --language golang --transport stdio --docker --examples

                    # Interactive (missing options will prompt)
                    ./mcpcli generate
                

Flags:

--name, -n Project name
--language, -l Programming language (golang, python, java, javascript/Node.js)
--transport, -t Transport method (stdio, rest, websocket)
--docker, -d Include Docker support
--examples, -e Include example resources and tools
--output, -o Output directory (default: project name)
--force, -f Overwrite existing directory

Develop

Start building your MCP server:

                    cd my-mcp-server
                    go run cmd/server/main.go
                

                    cd my-mcp-server
                    npm start
                

                    cd my-mcp-server
                    python main.py
                

                    cd my-mcp-server
                    mvn spring-boot:run
                

Test

Validate your server works correctly:

                    # Run all tests with config file
                    ./mcpcli test --config configs/mcp-config.json --all

                    # Interactive mode (prompts for what to test)
                    ./mcpcli test
                

Flags:

--config, -c Path to MCP configuration file
--all Test all components (resources, tools, capabilities, init)
--resources Test resources
--tools Test tools
--capabilities Test capabilities
--init Test initialization
--script, -f Path to test script file

Run tests with -cover and keep coverage above 85%.

Global Flags

--verbose, -v Enable verbose output
--quiet, -q Suppress output