cn-dev-mcp

面向中国开发者的离线 MCP 工具集

节假日调休 · 工作日计算 · 身份证 / 信用代码 / 手机号校验 · 拼音 · 农历 · 行政区划 · uni-app / 小程序 / Element Plus / Vant 文档速查

特点

• 完全离线：数据都打包在里面，不联网、不调用第三方接口，没有服务器费用

• 数据有出处：节假日数据来自国务院办公厅放假通知，行政区划来自国家统计局公开数据

• 只校验格式：身份证、信用代码只检查格式和校验位，不查询、也不核验任何人或企业的真实信息

• 一行命令启动：npx -y github:MsNan/cn-dev-mcp，支持 Cursor、Claude Code、Claude Desktop、Trae、Cherry Studio 等所有支持 stdio 的 MCP 客户端

Related MCP server: mcp-chrono

安装配置

需要 Node.js 18 或更高版本，npm 10 或更高版本（npm -v 查看；npm 9 直接 npx GitHub 仓库可能会静默失败，用 npm i -g npm@10 升级即可）。第一次启动时 npx 会先下载，大约需要十几秒。

Cursor

在 ~/.cursor/mcp.json（全局）或项目里的 .cursor/mcp.json 中添加：

{
  "mcpServers": {
    "cn-dev": { "command": "npx", "args": ["-y", "github:MsNan/cn-dev-mcp"] }
  }
}

Claude Code

claude mcp add cn-dev -- npx -y github:MsNan/cn-dev-mcp

Claude Desktop

编辑 claude_desktop_config.json（macOS 在 ~/Library/Application Support/Claude/，Windows 在 %APPDATA%\Claude\）：

{
  "mcpServers": {
    "cn-dev": { "command": "npx", "args": ["-y", "github:MsNan/cn-dev-mcp"] }
  }
}

Trae

打开 AI 对话框右上角设置 → MCP → 添加 → 手动配置，粘贴：

{
  "mcpServers": {
    "cn-dev": { "command": "npx", "args": ["-y", "github:MsNan/cn-dev-mcp"] }
  }
}

Cherry Studio

设置 → MCP 服务器 → 添加服务器：类型选 stdio，命令填 npx，参数填两行：-y 和 github:MsNan/cn-dev-mcp，保存后启用。

💡 Windows 上如果启动失败，可以把命令改成 cmd，参数改成 /c npx -y github:MsNan/cn-dev-mcp。

工具列表

返回示例

holiday_check { "date": "2026-10-10" }

{ "date": "2026-10-10", "weekday": "周六", "type": "调休上班", "isWorkday": true, "dataAvailable": true }

workday_add { "date": "2026-09-30", "n": 3 }

{ "from": "2026-09-30", "n": 3, "result": "2026-10-10", "weekday": "周六", "notes": [] }

lunar_to_solar { "year": 2026, "month": 8, "day": 15 }

{ "solar": "2026-09-25", "weekday": "周五", "lunar": { "text": "二〇二六年八月十五" }, "zodiac": "马", "festivals": ["中秋节"] }

数据说明

本地开发

git clone https://github.com/MsNan/cn-dev-mcp && cd cn-dev-mcp
npm install
npm test        # 编译，然后跑单元测试 + MCP stdio 冒烟测试
npx @modelcontextprotocol/inspector node dist/index.js   # 可视化调试

欢迎提 PR 补充文档条目（src/data/docs.ts）和新工具。

相关项目

• vue-uniapp-skills：Vue3 + uni-app 中文 AI 编程技能包，一行命令装进 Cursor、Claude Code、Trae、Codex。和本项目一起用效果更好。

• 作者博客：msnan.github.io · 公众号：程序员项目库

License

MIT © Theo（涛哥）

☕ 打赏支持

如果这个工具帮你省了时间，欢迎请我喝杯咖啡，也欢迎点个 ⭐ Star。