BOM-MCP

Base de datos de piezas y lista de materiales (BOM) de bombas electrosumergibles (ESP) con servidor MCP para asistentes de IA.

Características

• Base de datos SQLite con piezas, ensamblajes y unidades ESP

• Servidor MCP (transporte SSE) para asistentes de IA

• Interfaz de usuario de aplicaciones MCP - Vistas interactivas que se renderizan dentro de Claude Desktop/Claude.ai

• Interfaz de línea de comandos

• Servidor de API REST (opcional)

Related MCP server: maximo-mcp-ai-integration

Instalación

# Python dependencies
pip install -r requirements.txt

# Node.js dependencies for MCP Apps UI
cd mcp_app && npm install

Uso

Arquitectura

El sistema consta de dos partes:

1. Servidor MCP en Python - Base de datos y herramientas principales

2. Servidor de aplicaciones MCP en Node.js - Capa de interfaz de usuario que envuelve al servidor de Python

Stack completo (Recomendado)

# 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

Solo servidor MCP en Python (CLI/REST)

# SSE transport (default for MCP)
python run_mcp.py --port 8080

# REST API (optional)
python api.py [port]  # Default port: 5000

Comandos 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

Vistas de la interfaz de usuario de aplicaciones MCP

La capa de aplicaciones MCP proporciona 5 vistas interactivas que se renderizan dentro de Claude Desktop/Claude.ai:

Uso de las vistas

Activa las vistas preguntando a Claude:

• "Muéstrame el panel de control de ESP"

• "Muestra el catálogo de ESP"

• "Muestra la BOM para ESP-001"

• "Gestionar piezas"

• "Gestionar ensamblajes"

Herramientas MCP

Herramientas ESP

Herramientas de piezas

Herramientas de ensamblaje

Herramientas del sistema

Recursos MCP

Recursos de habilidades (skill://)

Nota de migración: los archivos markdown de habilidades ahora residen en .skills/ en lugar de skills/. Cada archivo .skills/*.md se descubre automáticamente y se expone como skill://<nombre_de_archivo>. Usa skill://index para ver el catálogo en vivo y los diagnósticos de descubrimiento.

Ejemplo de frase de activación:

• "Evalúa la selección de ESP y la preparación de la BOM"

Modelo de datos

• Piezas: Componentes individuales (part_number, name, category, material, weight_kg, is_critical, uom)

• Ensamblajes: Grupos de piezas

• Unidades ESP: Bombas de nivel superior que vinculan ensamblajes

Docker

Desarrollo local

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

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

Despliegue en Google Cloud Run

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

Licencia

MIT