Gen Mcp

What is Gen Mcp

gen-mcp is a command-line interface (CLI) tool designed to generate scaffolding for MCP server projects, particularly aimed at simplifying the development process for TypeScript users.

Use cases

Use cases for gen-mcp include developing MCP services for command-line tools, integrating with web applications, and creating prototypes for AI agents.

How to use

To use gen-mcp, install it globally using npm with ‘npm install -g gen-mcp’ or run it directly with ‘npx gen-mcp’. After installation, create a project by running ‘gen-mcp’, selecting a template (Stdio or SSE), specifying the installation path, and entering the package name.

Key features

Key features of gen-mcp include support for two main transport methods (SSE and Stdio), full TypeScript support, built-in example applications, and a simple command-line interface for user interaction.

Where to use

gen-mcp can be used in various fields where MCP services are required, such as AI development, command-line tool integration, and web application development.

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

为了解决这个问题，我开发了一个简单易用的 MCP CLI 工具：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 Server - Stdio 传输

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

主要特点：

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

MCP Server - SSE 传输

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

主要特点：

• 使用 Server-Sent 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

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

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

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

注意

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