MCP Tool Group Designer

MCP工具组设计器

一个独立的web应用程序，帮助产品经理设计小型、专注的MCP工具组（最多5个工具），从可用的产品树XML开始。

它的作用

MCP工具组设计器帮助产品经理：

1. 上传产品树XML -从你的产品树开始，作为真理的来源
2. 选择上下文 -选择工具组用于产品树的哪个部分
3. 设计工具 -创建多达5个带有输入、输出和示例的工具（带有AI支持的建议）
4. 定义路由 -设置触发短语和示例查询（带有人工智能建议）
5. 验证 -检查与产品树上下文的对齐情况
6. 出口 -生成可运行的MCP服务器包（Node.js和Python）
7. 测试 -尝试查询，看看工具如何响应

快速开始

🌐 Web部署（推荐）

对于Web部署：

1. 使用 web-deploy/ 文件夹 -包含完整堆栈版本
2. 部署到任何Node.js主机 （Heroku、Railway、Render等）
3. 看 web-deploy/README.md 有关详细的部署说明

🖥️ 本地安装

选项1：快速启动脚本

cd public-repos/mcp-tool-group-designer/web-deploy
npm install
npm start

然后打开 http://localhost:3000 在您的浏览器中。

选项2：直接访问

1. 打开 ui/index.html 在浏览器中
2. 注： 这需要后端服务器运行（请参阅web部署）

特性

基于人工智能的建议

• 工具组建议：请Dot根据产品树上下文建议整个工具组
• 工具建议：来自工作项的AI生成的工具建议
• 查询生成示例：Dot从JTBD生成真实的示例查询

产品树集成

• 上传并解析产品树XML
• 选择上下文（目标、作业或工作项）
• 生成JTBD报表
• 从工作项中提取用例

工具设计

• 每组最多设计5个工具
• 定义输入、输出和示例
• 工具验证
• MCP JSON模式生成

路由配置

• 定义触发短语
• 添加示例查询
• 产品树中的自动建议触发器
• 具有匹配强度的路由模拟

验证和导出

• 覆盖范围检查（工作项目→ 工具映射）
• 范围验证
• 生成Node.js或Python MCP服务器包
• 一键ZIP下载

测试

• 应用内查询测试
• 路由模拟
• 上下文感知测试

项目结构

mcp-tool-group-designer/
├── ui/                    # Frontend (HTML/CSS/JS)
│   ├── index.html        # Main application page
│   ├── app.js            # Application logic
│   ├── styles.css        # GarethAPI design language
│   ├── fonts/            # Local fonts
│   └── tool-analytics.js # Analytics integration
├── web-deploy/           # Production deployment
│   ├── server.js         # Express server
│   ├── package.json      # Dependencies
│   ├── public/           # Static assets
│   ├── Dockerfile        # Container deployment
│   └── README.md         # Deployment guide
└── README.md            # This file

配置

环境变量

应用程序支持以下环境变量：

• PORT -服务器端口号（默认值： 3000)
• CENTRAL_AI_ENDPOINT -集中式AI服务端点的URL（默认值： https://garethapi.com/central-ai/internal/ai/generate)

重要：对于生产部署，配置自己的AI服务端点。默认端点仅用于演示目的。

例子：

export CENTRAL_AI_ENDPOINT="https://your-ai-service.com/api/generate"
export PORT=8080
npm start

API终点

产品结构树

• POST /api/process-product-tree -解析产品树XML
• POST /api/generate-jtbd -从上下文生成JTBD
• POST /api/generate-use-cases -从工作项生成用例

工具设计

• POST /api/suggest-tool-group -人工智能工具组建议
• POST /api/suggest-tools-from-work-items -从工作项中推荐工具
• POST /api/validate-tool-definition -验证工具
• POST /api/generate-tool-schema -生成MCP模式

路由

• POST /api/suggest-routing-triggers -建议触发器
• POST /api/generate-example-queries -基于AI的示例查询生成
• POST /api/simulate-routing -测试路线

验证

• POST /api/validate-tool-group -运行验证

出口

• POST /api/generate-mcp-server -生成服务器包（返回ZIP）

依赖项

后端

• Node.js 18+
• 表达
• xml2js
• 归档器
• 节点获取
• 通用唯一标识符
• js yaml

前端

• 普通JavaScript（无框架）
• 字体真棒图标
• 谷歌字体（汉肯格罗地亚语）

部署

地方发展

cd web-deploy
npm install
npm start

生产

部署 web-deploy/ Node.js托管服务的目录。Express服务器从以下位置提供静态文件 public/ 目录。

码头工人

cd web-deploy
docker build -t mcp-tool-group-designer .
docker run -p 3000:3000 mcp-tool-group-designer

许可证

麻省理工学院

支持

有关问题或疑问，请访问garethapi.com