BOM-MCP
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사용법
아키텍처
시스템은 두 부분으로 구성됩니다:
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 servePython 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 Apps UI 뷰
MCP Apps 계층은 Claude Desktop/Claude.ai 내에서 렌더링되는 5가지 대화형 뷰를 제공합니다:
뷰 | 도구 | 설명 |
대시보드 |
| 통계 타일, 중요 부품 알림, 시리즈 요약 |
ESP 카탈로그 |
| 필터, 생성, 삭제 기능이 있는 ESP 카드 |
BOM 뷰어 |
| 정렬 및 CSV 내보내기 기능이 있는 BOM 테이블 |
부품 관리자 |
| 검색, 필터, CRUD 기능이 있는 부품 테이블 |
조립품 관리자 |
| 부품 관리가 포함된 조립품 카드 |
뷰 사용하기
Claude에게 요청하여 뷰를 트리거하세요:
"Show me the ESP dashboard"
"Show ESP catalogue"
"Show BOM for ESP-001"
"Manage parts"
"Manage assemblies"
MCP 도구
ESP 도구
도구 | 설명 |
| 모든 ESP 펌프 모델 나열 |
| 조립품 및 부품을 포함한 전체 ESP 가져오기 |
| ESP에 대한 플랫 BOM 부품 목록 가져오기 |
| BOM 요약(중량, 수량, 중요도) 가져오기 |
| 시리즈별로 ESP 필터링 |
| ESP CRUD 작업 |
부품 도구
도구 | 설명 |
| 모든 부품 나열 |
| 부품 세부 정보 가져오기 |
| 쿼리로 부품 검색 |
| 카테고리별 필터링 |
| 중요 부품 나열 |
| 부품 CRUD |
조립품 도구
도구 | 설명 |
| 모든 조립품 나열 |
| 부품이 포함된 조립품 가져오기 |
| 조립품을 사용하는 ESP 찾기 |
| 조립품 부품 관리 |
| 부품 수량 업데이트 |
시스템 도구
도구 | 설명 |
| 데이터베이스 통계 |
| 서버 정보 |
MCP 리소스
스킬 리소스 (skill://)
마이그레이션 참고: 스킬 마크다운 파일은 이제 skills/ 대신 .skills/에 위치합니다.
각 .skills/*.md 파일은 자동으로 검색되어 skill://<filename>으로 노출됩니다.
skill://index를 사용하여 라이브 카탈로그 및 검색 진단을 확인하세요.
리소스 URI | 이름 | 설명 |
| 스킬 인덱스 | 설명 및 새로 고침 상태와 함께 검색된 스킬의 집계 목록 |
| ESP 선택 및 BOM 준비 상태 평가 | 에이전트가 ESP 후보의 순위를 매기고 기존 MCP 도구를 사용하여 BOM 준비/조달 알림을 생성하도록 안내하는 지침 리소스 |
트리거 문구 예시:
"Assess ESP selection and BOM readiness"
데이터 모델
부품: 개별 구성 요소 (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:8080Google Cloud Run 배포
# Deploy Python MCP server
gcloud run deploy bom-mcp-server \
--source . \
--platform managed \
--region us-central1 \
--allow-unauthenticated라이선스
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Discover, plan and run tools across your connected business systems through one OAuth MCP endpoint
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Unified MCP Server is a remote MCP connector for AI agents and vertical AI products that provides access to 22,000+ authorized SaaS tools across 400+ integrations and 24 categories directly inside LLMs (Claude, GPT, Gemini, Cohere). Tools operate only on explicitly authorized customer connections, enabling agents to safely read and write against live third-party systems.
Related MCP Servers
- AlicenseBqualityBmaintenanceMCP server that gives LLMs access to petroleum engineering data and tools. Parse well logs, query production data, fit decline curves, calculate EUR, and run nodal analysis -- all through natural language with any MCP-compatible AI assistant.831MIT

@splice-cad/mcpofficial
AlicenseAqualityBmaintenanceMCP server for Splice CAD cable assembly and wiring harness design tool. Enables AI agents to search parts, build harness plans, create components with specs, and generate manufacturing documentation.2814 npm1MIT- AlicenseNot gradedqualityCmaintenanceExposes industrial motor telemetry data to AI agents via MCP and REST, enabling natural-language queries about motor status, health, and alerts. Provides a single tool and resource for retrieving real-time motor metrics and escalating critical conditions.MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLMs to read and modify the EPLAN Electric P8 data model through MCP, including listing pages, reading devices and parts, copying circuits, renaming tags, and fixing texts.MIT