create-mcp-server

生产级 MCP Server 脚手架 | Python + TypeScript 双版本 | 三分钟跑起来

create-mcp-server 是一个开箱即用的 MCP (Model Context Protocol) Server 脚手架，帮你快速搭建符合协议的 AI 工具服务。Python 和 TypeScript 两套实现，覆盖不同技术栈团队的需求。

---

为什么用这个？

• 双语言覆盖 — Python 版和 TypeScript 版各自独立，选你团队熟悉的栈
• 生产级内置 — 认证、日志、健康检查、参数校验、错误处理，开箱即用
• 三分钟上手 — pip install / npm install + 填 .env = 跑起来
• 容器化部署 — Docker + docker-compose + CI，拿来就用
• 双传输协议 — HTTP (SSE) 和 STDIO 两种 MCP 传输方式都支持

版本对比

版本	目录	技术栈	适用场景
Python	py/	FastAPI + pydantic-settings + mcp + psycopg2	AI 后端、数据管道、快速原型
TypeScript	ts/	Express + @modelcontextprotocol/sdk + pino + zod	前端/全栈团队、Node 生态
TS 脚手架 CLI	ts/bin/index.js	命令行生成器	npx create-mcp-server 一键生成

核心能力

特性	Python	TypeScript
API Key 认证 (防时序攻击)	✅ hmac.compare_digest	✅ safe-compare
结构化日志	✅ Python logging	✅ pino
健康检查端点	✅ /health	✅ /health
文件系统沙箱 (防路径遍历)	✅	✅
数据库工具 (参数化查询)	✅ PostgreSQL	✅ PostgreSQL
双传输 (HTTP / STDIO)	✅	✅
Docker 一键部署	✅	✅
GitHub CI	✅	✅
环境变量配置	✅ pydantic-settings	✅ zod env schema

快速开始

Python 版

cd py
pip install -e .
cp .env.example .env
# 编辑 .env 填入你的 API KEY
python main.py

启动后服务监听 http://localhost:8000，可以通过 STDIO 或 HTTP SSE 与 MCP 客户端通信。

TypeScript 版

cd ts
npm install
cp template/.env.example template/.env
# 编辑 template/.env 填入你的 API KEY
npm run dev

启动后服务监听 http://localhost:3000。

或者用脚手架 CLI 生成新项目

cd ts
node bin/index.js my-mcp-server
cd my-mcp-server
npm install
npm run dev

API 端点

方法	路径	说明
GET	/health	健康检查
POST	/mcp	MCP 协议消息 (HTTP SSE)
STDIO	-	MCP 协议消息 (STDIO 传输)

认证方式：在请求头 / query 参数 / STDIO 初始化参数中传递 api_key。

项目结构

create-mcp-server/
├── py/                      # Python 版
│   ├── main.py              # 入口 + HTTP 服务器
│   ├── auth.py              # API Key 认证
│   ├── config.py            # 配置管理 (pydantic-settings)
│   ├── tools/               # MCP 工具实现
│   │   ├── file_server.py   # 文件操作工具
│   │   └── db_server.py     # 数据库工具
│   ├── Dockerfile           # 容器化部署
│   ├── docker-compose.yml   # 本地编排
│   └── .github/workflows/   # CI 配置
├── ts/                      # TypeScript 版
│   ├── bin/index.js         # CLI 脚手架生成器
│   ├── template/            # 生成的项目模板
│   │   ├── src/             # 源码 (core/server/stdio/tools)
│   │   ├── Dockerfile
│   │   └── docker-compose.yml
│   └── .github/workflows/
├── README.md
└── LICENSE

自己跑一下

git clone https://github.com/L-xj11/create-mcp-server.git
cd create-mcp-server

# 跑 Python 版
cd py && pip install -e . && cp .env.example .env && python main.py

# 或跑 TypeScript 版
cd ts && npm install && npm run dev

License

MIT