create-mcp-boilerplate

A lightweight CLI to instantly bootstrap a new Model Context Protocol (MCP) server.

Note: Requires Node 22.5.0+ to leverage the built-in node:sqlite database for zero-dependency, instant project scaffolding. No more node-gyp compile errors!

Features

• Interactive Prompts: Easily configure your new project name, language, database, and standard tools.
• Language Support: Scaffold an MCP server in TypeScript or Python.
• Optional Database Integration: Opt-in to generate working SQLite boilerplate (using node:sqlite for TS or sqlite3 for Python) with example add_note and list_notes tools.
• Standard MCP Tools: Optionally include official MCP tool servers (filesystem, GitHub, Brave Search, fetch) with dependencies and server config pre-wired.
• Batteries Included: Generates a working server with examples of:
  • 🛠️ Tools: Perform calculations or external actions.
  • 📖 Resources: Serve custom data dynamically.
  • 💬 Prompts: Generate dynamic conversational prompt templates.

Quickstart

Run the generator directly using npx:

npx create-mcp-boilerplate@latest my-mcp-server

Or provide arguments to skip the interactive prompts:

npx create-mcp-boilerplate@latest my-mcp-server --language typescript --database sqlite

Pass standard tools via the --tools flag (comma-separated, no spaces):

npx create-mcp-boilerplate@latest my-mcp-server --language typescript --database none --tools filesystem,github

Standard MCP Tools

During interactive setup you will be asked:

? Which standard MCP tools would you like to include? (Press Space to select)
❯ ◯ Filesystem  (@modelcontextprotocol/server-filesystem)
  ◯ GitHub      (@modelcontextprotocol/server-github)
  ◯ Brave Search (@modelcontextprotocol/server-brave-search)
  ◯ Fetch       (@modelcontextprotocol/server-fetch)

Selecting a tool will:

1. TypeScript — Add the npm package to package.json dependencies and add an import comment in src/index.ts.
2. Python — Add the pip package to pyproject.toml dependencies and add an import comment in src/server.py.

Available Tools

| Tool | npm package | pip package | Required env var | |---|---|---|---| | filesystem | @modelcontextprotocol/server-filesystem | mcp-server-filesystem | FILESYSTEM_ALLOWED_DIRS | | github | @modelcontextprotocol/server-github | mcp-server-github | GITHUB_PERSONAL_ACCESS_TOKEN | | brave-search | @modelcontextprotocol/server-brave-search | mcp-server-brave-search | BRAVE_API_KEY | | fetch | @modelcontextprotocol/server-fetch | mcp-server-fetch | — |

The import stubs in the generated server file serve as documentation anchors. Each tool server runs as a standalone MCP process; see the MCP servers repo for full configuration.

Running Your Scaffolded Server

TypeScript

The TypeScript template uses @modelcontextprotocol/sdk and zod. If you enabled SQLite, it uses the built-in node:sqlite module (requires Node 22.5.0+).

cd my-mcp-server
npm install
npm run build
npm start

Python

The Python template uses the official mcp SDK via FastMCP. If you enabled SQLite, it uses the built-in sqlite3 standard library.

cd my-mcp-server
pip install -e .
python src/server.py

License

MIT