BOM-MCP

用于 AI 助手的电动潜水泵 (ESP) 零件和物料清单 (BOM) 数据库及 MCP 服务器。

功能特性

• 包含 ESP 零件、装配体和单元的 SQLite 数据库

• 用于 AI 助手的 MCP 服务器 (SSE 传输)

• MCP Apps UI - 在 Claude Desktop/Claude.ai 中渲染的交互式视图

• 命令行界面

• REST API 服务器（可选）

Related MCP server: @splice-cad/mcp

安装

# 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 Apps UI 视图

MCP Apps 层提供了 5 个可在 Claude Desktop/Claude.ai 中渲染的交互式视图：

使用视图

通过询问 Claude 来触发视图：

• "Show me the ESP dashboard"

• "Show ESP catalogue"

• "Show BOM for ESP-001"

• "Manage parts"

• "Manage assemblies"

MCP 工具

ESP 工具

零件工具

装配工具

系统工具

MCP 资源

技能资源 (skill://)

迁移说明：技能 markdown 文件现在位于 .skills/ 而不是 skills/ 中。 每个 .skills/*.md 文件都会被自动发现并作为 skill://<filename> 公开。 使用 skill://index 查看实时目录和发现诊断信息。

触发短语示例：

• "Assess ESP selection and BOM readiness"

数据模型

• 零件 (Parts)：单个组件 (part_number, name, category, material, weight_kg, is_critical, uom)

• 装配体 (Assemblies)：零件组

• ESP 单元 (ESP Units)：连接装配体的顶层泵

Docker

本地开发

# Build and run both services
docker-compose up --build

# Python MCP server: http://localhost:3001
# MCP App UI: http://localhost:8080

Google Cloud Run 部署

# Deploy Python MCP server
gcloud run deploy bom-mcp-server \
  --source . \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated

许可证

MIT