lecepin/gen-mcp

在上一篇文章《快速开发一个 MCP 服务，增强你的 AI Agent》中，我们讨论了如何开发 MCP 服务来增强 AI Agent 的能力。但是，我注意到社区中缺乏一个好用的 MCP 脚手架工具，许多现有的工具要么不完善，要么已经停止维护。

为了解决这个问题，我开发了一个简单易用的 MCP CLI 工具：gen-mcp，它可以帮助开发者快速创建 MCP 服务项目，尤其对 TypeScript 用户更加友好。

为什么需要这个工具？

开发 MCP 服务时常常面临以下问题：

项目结构搭建繁琐
配置 TypeScript 环境需要额外工作
不同传输协议（如 SSE 和 Stdio）的实现方式不同
缺乏最佳实践的参考

gen-mcp正是为解决这些问题而生。

工具特点

支持两种主流传输方式：SSE 和 Stdio
提供完整的 TypeScript 支持
内置笔记应用示例，展示资源、工具和提示的使用
简单直观的命令行交互

快速上手

安装

# 全局安装
npm install -g gen-mcp

# 或者直接使用 npx
npx gen-mcp

创建项目

安装后，只需运行以下命令：

red-mcp
# 或
mcp
# 或
npx gen-mcp

按照交互提示：

选择模板（Stdio 或 SSE 传输）
指定安装路径
输入包名

然后，工具会自动为你创建项目，并提供后续步骤的指引。

模板介绍

MCP Server - Stdio 传输

这个模板适合开发命令行工具集成的 MCP 服务，比如与 Claude CLI 集成。

主要特点：

通过标准输入/输出流通信
适合开发命令行工具
可以通过npm link快速全局安装进行测试

MCP Server - SSE 传输

这个模板适合开发 Web 应用集成的 MCP 服务，比如与网页版 Claude 集成。

主要特点：

使用 Server-Sent Events 进行通信
内置 Express 服务器
支持 CORS，方便前端集成
提供开发模式自动重启

调试与配置

开发 MCP 服务时，调试和配置是两个关键环节。我们的模板提供了完善的支持：

调试功能

MCP Inspector 集成：每个模板都可以通过以下命令启动调试:
```
npm run inspector
```
Inspector 提供了直观的界面，可以实时查看资源、工具调用和提示的执行情况。
开发模式监控：SSE 模板内置了开发模式，会监听文件变化并自动重启服务:
```
npm run dev
```

配置 MCP 服务

将您开发的 MCP 服务添加非常简单：

Cursor 集成：
- 在 Cursor 中使用时，可以通过右侧栏"连接"面板添加自定义 MCP 服务
- 位置：~/.cursor/mcp.json
- 输入服务名称和 URL（对于 SSE 模板）
- 对于 Stdio 模板，可配置命令路径
Claude 集成：

同上
位置：~/Library/Application Support/Claude/claude_desktop_config.json

Cli 模式：

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

SSE 模式：

{
  "mcpServers": {
    "server-name": {
      "url": "http://localhost:3000/sse",
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

示例应用：笔记系统

两个模板都内置了一个简单的笔记系统示例，展示了 MCP 的三大核心功能：

资源(Resources)：通过note:///{id}URI 访问笔记
工具(Tools)：create_note工具用于创建新笔记
提示(Prompts)：summarize_notes用于生成所有笔记的摘要

这个示例不仅展示了 MCP 的基本用法，也为你自己的项目提供了参考架构。

注意

如果出现报错，可能是由于 nvm 等多版本管理工具导致 node 找不到。可以 which node 后，修改 index.js 的 shebang。