create-mcp-server-kit

Scaffold a production-ready Model Context Protocol (MCP) server in seconds.

Who is this for? Anyone who wants to ship an MCP server fast — with a starter that actually runs, a clean structure, and CI-ready defaults.

What you get (default template: ts-stdio)

• TypeScript + Zod validation
• stdio transport (ideal for local integrations like Claude Desktop)
• Example tools you can extend immediately (hello, add)
• Template includes GitHub Actions CI out of the box

Quick start

Option A: From this repo (works now)

git clone https://github.com/Epi-1120/create-mcp-server-kit
cd create-mcp-server-kit
node ./bin/create-mcp-server-kit.js my-mcp-server
cd my-mcp-server
npm run dev

Option B: After publishing to npm (recommended for users)

Once you publish to npm, users can run:

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

Or:

npm create mcp-server-kit@latest my-mcp-server

10-second sanity check

After scaffolding:

cd my-mcp-server
npm install
npm run build

What gets generated

Example output (simplified):

my-mcp-server/
  src/index.ts
  package.json
  tsconfig.json
  README.md
  .github/workflows/ci.yml

Using the generated server (Claude Desktop example)

1. Build your server:

npm run build

2. Configure your MCP client to run node dist/index.js.

The generated project includes a ready-to-copy config snippet in its own README.md.

MCP docs/spec: see the official site at https://modelcontextprotocol.io

Minimal Claude Desktop config (Windows example)

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "node",
      "args": ["C:\\\\full\\\\path\\\\to\\\\my-mcp-server\\\\dist\\\\index.js"]
    }
  }
}

Templates

• ts-stdio (default): TypeScript MCP server using @modelcontextprotocol/sdk + StdioServerTransport.

CLI options

--template <name>     Template name (default: ts-stdio)
--pm <npm|pnpm|yarn|bun>
                      Package manager to use for install
--name <pkg-name>     Override generated package name
--description <text>  Override generated description
--no-install          Skip dependency install
--no-git              Skip `git init`
--force               Write into a non-empty directory

Contributing

PRs welcome — especially additional templates (Streamable HTTP, OAuth, task-enabled tools) and improvements to the default template.

Publishing (optional)

If you want others to use it via npx/npm create, publish to npm:

1. Fill in package.json metadata (author/repository/homepage).
2. Run npm publish.

FAQ / Troubleshooting

I got MODULE_NOT_FOUND on Windows

Run the CLI entry file explicitly:

node ./create-mcp-server-kit/bin/create-mcp-server-kit.js my-mcp-server

Or from inside the repo:

npm run create -- my-mcp-server

Roadmap

• Add a ts-streamable-http template (remote server)
• Add an OAuth-enabled template
• Add more examples (resources, prompts, tasks)

中文（繁體）

這個專案是一個 MCP 伺服器腳手架：讓你用一行指令生成「可以直接跑」的 TypeScript + stdio MCP server（非常適合 Claude Desktop 這類本機整合）。

Social preview

請參考 assets/README.md（內含 assets/social-preview.svg 與上傳到 GitHub Social preview 的步驟）。