create-mcp-server-kit

mcp
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 12 GitHub stars
Code Fail
  • spawnSync — Synchronous process spawning in bin/create-mcp-server-kit.js
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This is a CLI scaffolding tool designed to quickly generate a starter template for a Model Context Protocol (MCP) server using TypeScript and Zod.

Security Assessment
Overall risk: Low. The tool is a project generator, meaning its primary job is to create files on your local machine. It does not request dangerous permissions, access sensitive personal data, or make suspicious external network requests. There are no hardcoded secrets. The automated scan did flag the use of synchronous process spawning (`spawnSync`). However, this is standard behavior for CLI scaffolding scripts and is likely used to execute package manager commands (like `npm install`) or initialize Git. There are no hidden dangers here.

Quality Assessment
The project appears to be in good health. It is freshly maintained with recent updates and uses the permissive MIT license. While the community trust footprint is currently small (12 GitHub stars), the repository includes standard professional defaults like a CI pipeline via GitHub Actions. The setup instructions are clear and align exactly with standard, safe Node.js development practices.

Verdict
Safe to use.
SUMMARY

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

README.md

create-mcp-server-kit

CI
node >=18
license MIT
stars

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
  1. 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 的步驟)。

Reviews (0)

No results found