AI导哈

电潜泵部件与物料清单数据库

一个包含电潜泵部件、组件和单元的SQLite数据库，提供MCP服务器支持AI助手交互式操作。

  • by agsinghmac
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 agsinghmac/bom-mcp

使用说明

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

用法

建筑

该系统由两部分组成：

  1. Python MCP服务器 -核心数据库和工具
  2. 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: 5000

CLI命令

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-001

MCP应用程序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://<filename>. 使用 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

许可证

麻省理工学院

相关 MCP