MCP工具组设计器
一个独立的web应用程序,帮助产品经理设计小型、专注的MCP工具组(最多5个工具),从可用的产品树XML开始。
它的作用
MCP工具组设计器帮助产品经理:
- 上传产品树XML -从你的产品树开始,作为真理的来源
- 选择上下文 -选择工具组用于产品树的哪个部分
- 设计工具 -创建多达5个带有输入、输出和示例的工具(带有AI支持的建议)
- 定义路由 -设置触发短语和示例查询(带有人工智能建议)
- 验证 -检查与产品树上下文的对齐情况
- 出口 -生成可运行的MCP服务器包(Node.js和Python)
- 测试 -尝试查询,看看工具如何响应
快速开始
🌐 Web部署(推荐)
对于Web部署:
- 使用
web-deploy/文件夹 -包含完整堆栈版本 - 部署到任何Node.js主机 (Heroku、Railway、Render等)
- 看
web-deploy/README.md有关详细的部署说明
🖥️ 本地安装
选项1:快速启动脚本```bash
cd public-repos/mcp-tool-group-designer/web-deploy
npm install
npm start
然后打开 `http://localhost:3000` 在您的浏览器中。
**选项2:直接访问**
1. **打开 `ui/index.html`** 在浏览器中
1. **注:** 这需要后端服务器运行(请参阅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服务端点。默认端点仅用于演示目的。
例子:```bash
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(无框架)
- 字体真棒图标
- 谷歌字体(汉肯格罗地亚语)
## 部署
### 地方发展```bash
cd web-deploy
npm install
npm start
生产
部署 web-deploy/ Node.js托管服务的目录。Express服务器从以下位置提供静态文件 public/ 目录。
码头工人```bash
cd web-deploy
docker build -t mcp-tool-group-designer .
docker run -p 3000:3000 mcp-tool-group-designer
```
许可证
麻省理工学院
支持
有关问题或疑问,请访问garethapi.com
