生成-MCP

【技术文档摘要】： 在之前的《快速开发MCP服务以增强AI代理》一文中，我们讨论了如何开发MCP服务来增强AI代理的能力。然而，我注意到社区中缺乏一个有用的MCP脚手架工具，许多现有的工具要么不完整，要么已经停止维护。

为了解决这个问题，我开发了一个简单易用的MCP命令行工具：gen-mcp。它可以帮助开发者快速创建MCP服务项目，特别是对于TypeScript用户来说更加友好。

我们为什么需要这个工具？

在开发MCP服务时，通常会遇到以下问题：

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

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

工具特性

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

快速开始

安装

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

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

创建项目

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

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

按照交互提示进行操作：

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

然后，工具将自动为您创建项目，并提供下一步指导。

模板介绍

MCP服务 - Stdio 传输

此模板适用于与命令行工具集成的MCP服务开发，例如与Claude CLI集成。

关键特性：

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

MCP服务 - SSE 传输

此模板适用于与Web应用程序集成的MCP服务开发，例如与Claude Web版集成。

关键特性：

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

调试和配置

调试和配置是开发MCP服务的两个关键步骤。我们的模板提供了全面的支持：

调试功能

1. MCP Inspector集成每个模板都可以通过以下命令进行调试：

   npm run inspector
   

   Inspector提供了一个直观的界面，允许实时查看资源、工具调用和提示的执行状态。

2. 开发模式监控SSE模板内置了开发模式，监听文件变化并自动重启服务

   npm run dev
   

配置MCP服务

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

1. Cursor 集成：

   • 在Cursor中，可以通过右侧栏的“连接”面板添加自定义MCP服务
   • 位置：~/.cursor/mcp.json
   • 输入服务名称和URL（针对SSE模板）
   • 对于Stdio模板，可以配置命令路径

2. Claude 集成：

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

命令行模式：

{
  "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的三大核心功能：

1. 资源：通过note:///{id}URI访问笔记
2. 工具：create_note用于创建新笔记
3. 提示：summarize_notes用于生成所有笔记的摘要

此示例不仅展示了MCP的基本用法，还为您的项目提供了一个参考架构。

注意事项

如果出现错误，可能是由于nvm等多版本管理工具导致的node未找到。可以使用which node检查，之后修改index.js中的shebang。 </中文翻译>