Skip to main content
Glama
Sign In
deenesjakoruzh
agsinghmac

BOM-MCP

by agsinghmac
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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: @splice-cad/mcp

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:

Vista

Herramienta

Descripción

Panel de control

view_dashboard

Mosaicos de estadísticas, alerta de piezas críticas, resumen de series

Catálogo ESP

view_esp_catalogue

Tarjetas ESP con filtro, creación y eliminación

Visor de BOM

view_esp_bom

Tabla de BOM con ordenamiento y exportación a CSV

Gestor de piezas

manage_parts

Tabla de piezas con búsqueda, filtros y CRUD

Gestor de ensamblajes

manage_assemblies

Tarjetas de ensamblaje con gestión de piezas

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

Herramienta

Descripción

list_esps

Listar todos los modelos de bombas ESP

get_esp

Obtener ESP completa con ensamblajes y piezas

get_esp_bom

Obtener lista plana de piezas de la BOM para una ESP

get_bom_summary

Obtener resumen de la BOM (peso, conteos, crítico)

get_esps_by_series

Filtrar ESP por serie

create_esp, update_esp, delete_esp

Operaciones CRUD de ESP

Herramientas de piezas

Herramienta

Descripción

list_parts

Listar todas las piezas

get_part

Obtener detalles de la pieza

search_parts

Buscar piezas por consulta

get_parts_by_category

Filtrar por categoría

get_critical_parts

Listar piezas críticas

create_part, update_part, delete_part

CRUD de piezas

Herramientas de ensamblaje

Herramienta

Descripción

list_assemblies

Listar todos los ensamblajes

get_assembly

Obtener ensamblaje con piezas

get_assembly_esps

Encontrar ESP que usan el ensamblaje

add_part_to_assembly, remove_part_from_assembly

Gestionar piezas del ensamblaje

update_assembly_part_quantity

Actualizar cantidades de piezas

Herramientas del sistema

Herramienta

Descripción

get_stats

Estadísticas de la base de datos

get_server_info

Información del servidor

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.

URI del recurso

Nombre

Descripción

skill://index

Índice de habilidades

Lista agregada de habilidades descubiertas con descripciones y estado de actualización

skill://esp_selection_bom_readiness

Evaluación de selección de ESP y preparación de BOM

Recurso de instrucción que guía a los agentes para clasificar candidatos ESP y generar alertas de preparación/adquisición de BOM usando herramientas MCP existentes

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • petropt/petro-mcpprivate

    petropt
    A
    license
    B
    quality
    B
    maintenance
    MCP 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.
    83
    1
    MIT
  • @splice-cad/mcp by splice-cad

    @splice-cad/mcpofficial

    splice-cad
    A
    license
    A
    quality
    B
    maintenance
    MCP 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.
    28
    14 npm
    1
    MIT

  • motor-telemetry-mcp

    0xcf02
    A
    license
    Not graded
    quality
    C
    maintenance
    Exposes 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

  • eplan-mcp-bridge

    paulinholt
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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