create-mcp-server

CLI scaffolding tool for creating Model Context Protocol (MCP) servers. Think create-next-app but for MCP servers.

Quick Start

npx create-mcp-server my-server

Usage

# Interactive mode
npx create-mcp-server my-server

# Non-interactive with defaults
npx create-mcp-server my-server --yes

# Fully specified
npx create-mcp-server my-server \
  --name my-server \
  --description "My custom MCP server" \
  --transport stdio \
  --template full \
  --pm pnpm

Options

| Option | Description | Choices | |--------|-------------|---------| | --name | Server name | any string | | --description | Server description | any string | | --transport | Transport type | stdio, sse, http | | --template | Project template | minimal, with-tools, with-resources, full | | --pm | Package manager | npm, pnpm, yarn | | --yes | Skip prompts, use defaults | - |

Templates

minimal

A bare MCP server with a single ping tool. Good starting point for custom servers.

with-tools

Includes example tools demonstrating:

• String input parameters (greet)
• Numeric inputs with enum operations (calculate)
• No-argument tools returning structured data (get-timestamp)

with-resources

Includes example resources demonstrating:

• Static resources (server-info)
• Dynamic resource templates with URI parameters (item lookup)

full

Everything: tools, resources, and prompts. Includes all examples from other templates plus:

• Simple prompts (system-status)
• Parameterized prompts with Zod schemas (code-review)
• Multi-turn conversation prompts (explain-concept)

Generated Project Structure

my-server/
├── package.json
├── tsconfig.json
├── .gitignore
├── README.md
├── src/
│   ├── index.ts
│   ├── tools/          (with-tools, full)
│   │   └── example.ts
│   ├── resources/      (with-resources, full)
│   │   └── example.ts
│   └── prompts/        (full only)
│       └── example.ts
└── test/
    └── server.test.ts

Development

git clone <repo>
cd create-mcp-server
npm install
npm run build
node dist/index.js my-test-server

License

MIT