home / mcp / bom-mcp mcp server

BOM-MCP MCP Server

Provides ESP BOM data via an MCP server for AI assistants with optional REST API.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "agsinghmac-bom-mcp": {
      "command": "python",
      "args": [
        "run_mcp.py",
        "--port",
        "8080"
      ]
    }
  }
}

This MCP server provides a focused interface for managing Electric Submersible Pump (ESP) parts and BOM data, enabling AI assistants to access parts, assemblies, units, and BOM information through both a streaming MCP interface and an optional REST API.

How to use

You can run the MCP server to enable AI assistants to query ESP parts, BOMs, and assemblies. Use the default SSE transport for interactive conversations and data retrieval, or enable the optional REST API for programmatic access. Start the MCP server, then connect your MCP client to the provided endpoints to list ESP models, fetch full ESP details with assemblies, view BOMs, and retrieve parts by category.

How to install

Prerequisites: Python is installed on your system. You should also have access to your shell or terminal.

Install required Python packages from the project requirements.

Additional notes

Data model includes Parts, Assemblies, and ESP Units to organize components and top-level pumps.

Docker usage is available for local development, including building and running the MCP server via docker-compose.

The project is released under the MIT license.

Available tools

list_esps

List all ESP pump models available in the BOM database.

get_esp

Retrieve a complete ESP including its assemblies and parts.

get_esp_bom

Get a flat BOM parts list for a specific ESP.

get_bom_summary

Generate a BOM summary with weight, part counts, and critical parts.

get_parts_by_category

Filter parts by their category.

get_critical_parts

List all critical parts across ESP models.

get_assembly

Retrieve a specific assembly along with its constituent parts.