MCP Servers

 ███╗   ██╗███████╗██╗  ██╗██╗   ██╗███████╗
 ████╗  ██║██╔════╝╚██╗██╔╝██║   ██║██╔════╝
 ██╔██╗ ██║█████╗   ╚███╔╝ ██║   ██║███████╗
 ██║╚██╗██║██╔══╝   ██╔██╗ ██║   ██║╚════██║
 ██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝███████║
 ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝
 ███████╗ ██████╗ ██████╗  ██████╗  ██████╗ ████████╗
 ██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔═══██╗╚══██╔══╝
 █████╗  ██║   ██║██████╔╝██║  ███╗██║   ██║   ██║
 ██╔══╝  ██║   ██║██╔══██╗██║   ██║██║   ██║   ██║
 ██║     ╚██████╔╝██║  ██║╚██████╔╝╚██████╔╝   ██║
 ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝  ╚═════╝    ╚═╝

# 安装（全球 & 国内均可用）
npm create @zgc37359/mcplab@latest

# 或者
npm install -g @zgc37359/mcplab

特性一览

| | | |---|---| | ⚡ 30 秒出活儿 | 交互式 TUI，选模板、选协议、配置项点点就完成 | | 🔥 热重载 | 改代码实时重启，不用每次手动 kill && node | | 🧪 交互式调试 | 在终端里直接测试每个 Tool，无需连接 Claude Desktop | | 🩺 健康诊断 | 7 项检测，告诉你为什么 MCP Server 跑不起来 | | 🌐 中文原生 | 中文提示、中文错误信息、国内模板（飞书） | | 🔌 5 种模板 | blank / OpenAPI / 数据库 / 爬虫 / 飞书 | | 🚀 3 种传输协议 | stdio / SSE / Streamable HTTP | | ⚙️ pnpm workspace | monorepo 结构，依赖管理清晰 |

快速开始

创建项目

npm create @zgc37359/mcplab@latest

交互式流程示例：

┌─────────────────────────────────────────────┐
│                                             │
│          ⚡ mcplab  MCP 开发工具套件          │
│                                             │
│  ? 项目名称                                  │
│    my-mcp-server                        ↵   │
│                                             │
│  ? 选择模板 (Use arrow keys)                 │
│    ❯ 空白项目  — 从零开始                    │
│      OpenAPI 导入 — 从 API 文档生成          │
│      数据库连接器 — MySQL / PostgreSQL       │
│      网页爬虫 — 抓取网页 / JSON API           │
│      飞书集成 — 消息 / 文档 / 表格            │
│                                             │
│  ? 选择传输方式 (Use arrow keys)             │
│    ❯ stdio          — 本地 / Claude Desktop  │
│      SSE            — 远程部署               │
│      Streamable HTTP — 新型协议（推荐）       │
│                                             │
│  ? 启用 Vitest 测试？ Yes                   │
│                                             │
│         ✓  项目创建成功！                    │
│                                             │
│  cd my-mcp-server && npm install           │
│  mcplab dev                                │
│                                             │
└─────────────────────────────────────────────┘

开发调试

# 热重载开发服务器
mcplab dev

# 交互式 Tool 调试（不需要 Claude）
mcplab inspect

# 项目健康检查
mcplab doctor

接入 Claude Desktop

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "my-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/my-mcp-server/dist/index.js"]
    }
  }
}

模板详解

🟪 飞书集成（国内独家）

让 Claude Desktop 直接操控飞书，是 mcplab 与所有国外工具的核心差异点：

// 注册的 Tools
send-message  — 发送消息到飞书群
list-chats     — 列出所有群聊
create-doc    — 创建飞书文档
list-sheets   — 查询多维表格

🟦 OpenAPI 导入

把已有的 OpenAPI 规范文件丢进去，自动生成对应的 MCP Tools：

mcplab init my-api --template openapi
# 把你的 openapi.yaml 放进去，自动生成 Tools

🟨 数据库连接器

// 自动防护：只允许 SELECT 语句，防止注入
query       — 执行只读 SQL 查询
list-tables — 列出所有表
describe    — 查看表结构

与社区工具对比

| | mcplab | create-mcp-server
(官方·已归档) | 手写代码 | |---|:---:|:---:|:---:| | 状态 | 活跃维护 | ❌ 已归档 | — | | 中文界面 | ✅ 原生 | ❌ | ❌ | | 热重载 | ✅ | ❌ | ❌ | | 交互调试 | ✅ | ❌ | ❌ | | 健康检查 | ✅ | ❌ | ❌ | | 飞书模板 | ✅ | ❌ | ❌ | | OpenAPI 模板 | ✅ | ❌ | ❌ | | 多协议支持 | ✅ | ❌ | ❌ |

命令参考

| 命令 | 说明 | |------|------| | mcplab init [name] | 创建新项目 | | mcplab dev | 热重载开发服务器 | | mcplab inspect | 交互式 Tool 调试 | | mcplab doctor | 项目健康检查 | | mcplab --lang en | 切换英文界面 | | mcplab --help | 查看帮助 |

技术栈

| 包 | 用途 | |---|---| | @modelcontextprotocol/sdk | MCP 协议实现 | | citty | CLI 框架 | | @clack/prompts | 终端 UI | | chokidar | 文件监听 | | picocolors | 彩色日志 | | tsup | TypeScript 构建 |

本地开发

git clone https://github.com/zgc37359-lang/mcplab.git
cd mcplab
pnpm install
pnpm build