Gen Mcp
About
Generate mcp server scaffolding
Details
- Author
- lecepin
- GitHub stars
- 7
- Downloads
- 280
- Categories
- Other
Jump to
- 支持SSE和Stdio两种传输方式
- 提供完整TypeScript支持
- 内置笔记应用示例展示核心功能
- 简单直观的命令行交互
- 模板自动生成项目结构
- 集成MCP Inspector调试工具
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Gen McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
通过npm全局安装（npm install -g gen-mcp）或直接使用npx（npx gen-mcp）运行，然后按照交互提示选择模板（Stdio或SSE）、指定安装路径并输入包名，工具会自动创建项目并给出后续指引。可使用npm run inspector启动调试，或配置Cursor/Claude的MCP JSON文件。
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gen mcp": {
"gen-mcp": {
"command": "npx",
"args": [
"gen-mcp"
]
}
}
}
}McpServers
{
"gen-mcp": {
"command": "npx",
"args": [
"gen-mcp"
]
}
}在上一篇文章《快速开发一个 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。
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
