BOM-MCP
配备MCP服务器的电动潜水泵（ESP）零件和物料清单（BOM）数据库，用于AI助手。
特性
- 包含ESP零件、组件和单元的SQLite数据库
- 用于AI助手的MCP服务器（SSE传输）
- MCP应用程序UI -在Claude Desktop/Claude.ai中渲染的交互式视图
- 命令行界面
- REST API服务器（可选）
安装
# Python dependencies
pip install -r requirements.txt
# Node.js dependencies for MCP Apps UI
cd mcp_app && npm install用法
建筑
该系统由两部分组成：
- Python MCP服务器 -核心数据库和工具
- Node.js MCP应用服务器 -封装Python服务器的UI层
全栈（推荐）
# Terminal 1: Start Python MCP server on port 3001
python run_mcp.py --port 3001
# Terminal 2: Start MCP App UI server on port 8080
cd mcp_app && npm run serve
# Or with custom port: PORT=8081 npm run serve仅限Python MCP服务器（CLI/REST）
# SSE transport (default for MCP)
python run_mcp.py --port 8080
# REST API (optional)
python api.py [port] # Default port: 5000CLI命令
python cli.py esp list
python cli.py esp get ESP-001
python cli.py esp bom ESP-001
python cli.py parts get ESP-MTR-001
python cli.py assemblies get ASM-MTR-001MCP应用程序UI视图
MCP Apps层提供了5个在Claude Desktop/Claude.ai中渲染的交互式视图：
| 视图 | 工具 | 描述 |
|---|---|---|
| 仪表板 | view_dashboard | 统计图块、关键部件警报、系列摘要 |
| ESP目录 | view_esp_catalogue | 带过滤器的ESP卡，创建、删除 |
| BOM查看器 | view_esp_bom | 带排序的BOM表，导出CSV |
| 零件经理 | manage_parts | 带搜索、过滤器、CRUD的零件表 |
| 装配经理 | manage_assemblies | 带有零件管理的装配卡 |
使用视图
通过询问Claude来触发视图：
- “显示ESP仪表板”
- “显示ESP目录”
- “显示ESP-001的物料清单”
- “管理零件”
- “管理程序集”
MCP工具
ESP工具
| 工具 | 说明 |
|---|---|
list_esps | 列出所有ESP泵型号 |
get_esp | 获得完整的ESP组件和零件 |
get_esp_bom | 获取ESP的平面BOM零件清单 |
get_bom_summary | 获取物料清单摘要（重量、计数、关键） |
get_esps_by_series | 按系列过滤ESP |
create_esp, update_esp, delete_esp | ESP CRUD操作 |
零件工具
| 工具 | 说明 |
|---|---|
list_parts | 列出所有零件 |
get_part | 获取零件详细信息 |
search_parts | 按查询搜索零件 |
get_parts_by_category | 按类别筛选 |
get_critical_parts | 列出关键部件 |
create_part, update_part, delete_part | 零件CRUD |
装配工具
| 工具 | 说明 |
|---|---|
list_assemblies | 列出所有程序集 |
get_assembly | 用零件组装 |
get_assembly_esps | 使用程序集查找ESP |
add_part_to_assembly, remove_part_from_assembly | 管理装配零件 |
update_assembly_part_quantity | 更新零件数量 |
系统工具
| 工具 | 说明 |
|---|---|
get_stats | 数据库统计 |
get_server_info | 服务器信息 |
MCP资源
技能资源(skill://)
迁移说明：技能标记文件现在存在 .skills/ 而不是 skills/. 每 .skills/*.md 文件被自动发现并公开为 skill://. 使用 skill://index 查看实时目录和发现诊断。
| 资源URI | 名称 | 描述 |
|---|---|---|
skill://index | 技能索引 | 已发现技能的汇总列表，包括描述和刷新状态 |
skill://esp_selection_bom_readiness | ESP选择和BOM准备就绪评估 | 指导代理对ESP候选人进行排名并使用现有MCP工具生成BOM准备就绪/采购警报的说明资源 |
触发短语示例：
- “评估ESP选择和BOM准备情况”
数据模型
- 零件：单个组件（零件编号、名称、类别、材料、重量、关键、uom）
- 装配件：零件组
- ESP装置：连接组件的顶层泵
码头工人
本地开发
# Build and run both services
docker-compose up --build
# Python MCP server: http://localhost:3001
# MCP App UI: http://localhost:8080谷歌云运行部署
# Deploy Python MCP server
gcloud run deploy bom-mcp-server \
--source . \
--platform managed \
--region us-central1 \
--allow-unauthenticated许可证
麻省理工学院