Skip to main content
Glama
Sign In
deenesjakoruzh
agsinghmac

BOM-MCP

by agsinghmac
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

BOM-MCP

База данных запчастей и спецификаций (BOM) для электропогружных насосов (ЭЦН) с MCP-сервером для ИИ-ассистентов.

Возможности

  • База данных SQLite с запчастями, сборками и агрегатами ЭЦН

  • 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

Использование

Архитектура

Система состоит из двух частей:

  1. Python MCP Server — ядро базы данных и инструменты

  2. Node.js MCP App Server — уровень пользовательского интерфейса, работающий поверх Python-сервера

Полный стек (рекомендуется)

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

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 предоставляет 5 интерактивных представлений, которые отображаются внутри Claude Desktop/Claude.ai:

Представление

Инструмент

Описание

Панель управления

view_dashboard

Плитки статистики, оповещения о критических деталях, сводка по сериям

Каталог ЭЦН

view_esp_catalogue

Карточки ЭЦН с фильтрацией, созданием и удалением

Просмотр BOM

view_esp_bom

Таблица BOM с сортировкой и экспортом в CSV

Управление запчастями

manage_parts

Таблица запчастей с поиском, фильтрами и CRUD

Управление сборками

manage_assemblies

Карточки сборок с управлением запчастями

Использование представлений

Запускайте представления, обращаясь к Claude:

  • "Show me the ESP dashboard"

  • "Show ESP catalogue"

  • "Show BOM for ESP-001"

  • "Manage parts"

  • "Manage assemblies"

Инструменты MCP

Инструменты ЭЦН

Инструмент

Описание

list_esps

Список всех моделей насосов ЭЦН

get_esp

Получить полный ЭЦН со сборками и запчастями

get_esp_bom

Получить плоский список запчастей BOM для ЭЦН

get_bom_summary

Получить сводку BOM (вес, количество, критичность)

get_esps_by_series

Фильтрация ЭЦН по сериям

create_esp, update_esp, delete_esp

Операции CRUD для ЭЦН

Инструменты запчастей

Инструмент

Описание

list_parts

Список всех запчастей

get_part

Получить детали запчасти

search_parts

Поиск запчастей по запросу

get_parts_by_category

Фильтрация по категории

get_critical_parts

Список критических запчастей

create_part, update_part, delete_part

CRUD запчастей

Инструменты сборок

Инструмент

Описание

list_assemblies

Список всех сборок

get_assembly

Получить сборку с запчастями

get_assembly_esps

Найти ЭЦН, использующие сборку

add_part_to_assembly, remove_part_from_assembly

Управление запчастями в сборке

update_assembly_part_quantity

Обновление количества запчастей

Системные инструменты

Инструмент

Описание

get_stats

Статистика базы данных

get_server_info

Информация о сервере

Ресурсы MCP

Ресурсы навыков (skill://)

Примечание по миграции: файлы markdown навыков теперь находятся в .skills/ вместо skills/. Каждый файл .skills/*.md автоматически обнаруживается и предоставляется как skill://<filename>. Используйте skill://index для просмотра актуального каталога и диагностики обнаружения.

URI ресурса

Имя

Описание

skill://index

Индекс навыков

Агрегированный список обнаруженных навыков с описаниями и статусом обновления

skill://esp_selection_bom_readiness

Оценка выбора ЭЦН и готовности BOM

Ресурс инструкций, который помогает агентам ранжировать кандидатов ЭЦН и генерировать оповещения о готовности BOM/закупках с использованием существующих инструментов MCP

Пример фразы для запуска:

  • "Assess ESP selection and BOM readiness"

Модель данных

  • Запчасти: Отдельные компоненты (part_number, name, category, material, weight_kg, is_critical, uom)

  • Сборки: Группы запчастей

  • Агрегаты ЭЦН: Насосы верхнего уровня, связывающие сборки

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

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