Skip to main content
Glama
Sign In
deenesjakoruzh
agsinghmac

BOM-MCP

by agsinghmac
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

BOM-MCP

Datenbank für Teile und Stücklisten (BOM) von elektrischen Tauchpumpen (ESP) mit MCP-Server für KI-Assistenten.

Funktionen

  • SQLite-Datenbank mit ESP-Teilen, Baugruppen und Einheiten

  • MCP-Server (SSE-Transport) für KI-Assistenten

  • MCP Apps UI - Interaktive Ansichten, die innerhalb von Claude Desktop/Claude.ai gerendert werden

  • Befehlszeilenschnittstelle (CLI)

  • REST-API-Server (optional)

Related MCP server: @splice-cad/mcp

Installation

# Python dependencies
pip install -r requirements.txt

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

Verwendung

Architektur

Das System besteht aus zwei Teilen:

  1. Python MCP-Server - Kern-Datenbank und Tools

  2. Node.js MCP-App-Server - UI-Ebene, die den Python-Server umschließt

Full Stack (Empfohlen)

# 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

Nur Python MCP-Server (CLI/REST)

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

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

CLI-Befehle

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-Ansichten

Die MCP Apps-Ebene bietet 5 interaktive Ansichten, die innerhalb von Claude Desktop/Claude.ai gerendert werden:

Ansicht

Tool

Beschreibung

Dashboard

view_dashboard

Statistik-Kacheeln, Warnung bei kritischen Teilen, Serienübersicht

ESP-Katalog

view_esp_catalogue

ESP-Karten mit Filtern, Erstellen, Löschen

BOM-Viewer

view_esp_bom

BOM-Tabelle mit Sortierung, CSV-Export

Teile-Manager

manage_parts

Teile-Tabelle mit Suche, Filtern, CRUD

Baugruppen-Manager

manage_assemblies

Baugruppen-Karten mit Teileverwaltung

Verwendung der Ansichten

Lösen Sie Ansichten aus, indem Sie Claude fragen:

  • "Zeige mir das ESP-Dashboard"

  • "Zeige den ESP-Katalog"

  • "Zeige die BOM für ESP-001"

  • "Verwalte Teile"

  • "Verwalte Baugruppen"

MCP-Tools

ESP-Tools

Tool

Beschreibung

list_esps

Alle ESP-Pumpenmodelle auflisten

get_esp

Vollständige ESP mit Baugruppen und Teilen abrufen

get_esp_bom

Flache BOM-Teileliste für eine ESP abrufen

get_bom_summary

BOM-Zusammenfassung abrufen (Gewicht, Anzahl, kritisch)

get_esps_by_series

ESPs nach Serie filtern

create_esp, update_esp, delete_esp

ESP CRUD-Operationen

Teile-Tools

Tool

Beschreibung

list_parts

Alle Teile auflisten

get_part

Teiledetails abrufen

search_parts

Teile nach Abfrage suchen

get_parts_by_category

Nach Kategorie filtern

get_critical_parts

Kritische Teile auflisten

create_part, update_part, delete_part

Teile CRUD

Baugruppen-Tools

Tool

Beschreibung

list_assemblies

Alle Baugruppen auflisten

get_assembly

Baugruppe mit Teilen abrufen

get_assembly_esps

ESPs finden, die eine Baugruppe verwenden

add_part_to_assembly, remove_part_from_assembly

Baugruppenteile verwalten

update_assembly_part_quantity

Teilemengen aktualisieren

System-Tools

Tool

Beschreibung

get_stats

Datenbankstatistiken

get_server_info

Serverinformationen

MCP-Ressourcen

Skill-Ressourcen (skill://)

Migrationshinweis: Skill-Markdown-Dateien befinden sich jetzt in .skills/ anstelle von skills/. Jede .skills/*.md-Datei wird automatisch erkannt und als skill://<dateiname> bereitgestellt. Verwenden Sie skill://index, um den Live-Katalog und die Erkennungsdiagnose anzuzeigen.

Ressourcen-URI

Name

Beschreibung

skill://index

Skill-Index

Aggregierte Liste erkannter Skills mit Beschreibungen und Aktualisierungsstatus

skill://esp_selection_bom_readiness

ESP-Auswahl & BOM-Bereitschaftsbewertung

Anweisungsressource, die Agenten anleitet, ESP-Kandidaten zu bewerten und BOM-Bereitschafts-/Beschaffungswarnungen unter Verwendung vorhandener MCP-Tools zu generieren

Beispiel für einen Auslösesatz:

  • "Bewerte die ESP-Auswahl und die BOM-Bereitschaft"

Datenmodell

  • Teile: Einzelne Komponenten (part_number, name, category, material, weight_kg, is_critical, uom)

  • Baugruppen: Gruppen von Teilen

  • ESP-Einheiten: Top-Level-Pumpen, die Baugruppen verknüpfen

Docker

Lokale Entwicklung

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

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

Google Cloud Run-Bereitstellung

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

Lizenz

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