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

使用方法

アーキテクチャ

システムは以下の2つの部分で構成されています：

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レイヤーは、Claude Desktop/Claude.ai内でレンダリングされる5つのインタラクティブなビューを提供します：

ビューの使用方法

Claudeに以下のように指示してビューを起動します：

• "Show me the ESP dashboard"（ESPダッシュボードを表示して）

• "Show ESP catalogue"（ESPカタログを表示して）

• "Show BOM for ESP-001"（ESP-001のBOMを表示して）

• "Manage parts"（部品を管理して）

• "Manage assemblies"（アセンブリを管理して）

MCPツール

ESPツール

部品ツール

アセンブリツール

システムツール

MCPリソース

スキルリソース (skill://)

移行に関する注意: スキルマークダウンファイルは、skills/ ではなく .skills/ に配置されるようになりました。 各 .skills/*.md ファイルは自動的に検出され、skill://<filename> として公開されます。 ライブカタログと検出診断を表示するには skill://index を使用してください。

トリガーフレーズの例:

• "Assess ESP selection and BOM readiness"（ESP選定とBOM準備状況を評価して）

データモデル

• 部品: 個々のコンポーネント (part_number, name, category, material, weight_kg, is_critical, uom)

• アセンブリ: 部品のグループ

• ESPユニット: アセンブリをリンクする最上位のポンプ

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