Parts

Source Parts MCP Server - Model Context Protocol integration

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sourceparts-parts-mcp": {
      "command": "python",
      "args": [
        "-m",
        "parts_mcp"
      ],
      "env": {
        "SOURCE_PARTS_API_KEY": "your_api_key_here",
        "SOURCE_PARTS_API_URL": "https://api.source.parts/v1"
      }
    }
  }
}

Parts MCP is a Python-based server you run locally to source electronic parts. It connects to the Source Parts API and provides a unified workflow to search components, compare prices, verify availability, and process BOMs from multiple EDA tools through a simple MCP client integration.

How to use

You interact with the Parts MCP server by launching it as a local MCP service and then connecting your MCP client or assistant to it. Use it to search for components, process BOMs from supported EDA tools, check real-time stock, compare pricing across distributors, and discover alternatives or drop-in replacements. The server exposes a set of capabilities you can invoke through your MCP client, enabling end-to-end component sourcing workflows from within your AI assistant.

How to install

Prerequisites: ensure you have Python 3.10 or newer installed on your system.

Install the MCP server from PyPI or run from source.

From PyPI (recommended):

pip install parts-mcp

From source

If you prefer to run directly from the repository, clone the project and install in editable mode.

Commands to run from the project root:

git clone https://github.com/SourceParts/parts-mcp.git
cd parts-mcp
pip install -e .

Run the MCP server locally

Start the MCP server using Python and the package’s module entry point. This runs a local server process that your MCP clients can connect to.

python -m parts_mcp

Configuration and API key

The server requires a Source Parts API key to access part data and pricing. You set this key in your environment so the server can authenticate with the Source Parts API.

# Required
SOURCE_PARTS_API_KEY=your_api_key_here

# Optional
SOURCE_PARTS_API_URL=https://api.source.parts/v1
KICAD_SEARCH_PATHS=/path/to/kicad/projects
PARTS_CACHE_DIR=~/.cache/parts-mcp
CACHE_EXPIRY_HOURS=24

Claude Desktop and Claude Code integration notes

To use Claude Desktop or Claude Code with Parts MCP, configure an MCP server entry that runs the Python module. The following examples show the concrete command and environment needed.

Available tools

search_parts

Search for components by query across the Source Parts catalog.

get_part_details

Retrieve detailed information about a specific part.

get_part_pricing

Fetch pricing data from multiple distributors for given parts.

check_availability

Check real-time stock levels across distributors.

find_alternatives

Identify drop-in replacements and functional equivalents.

process_bom

Process BOM files from supported EDA tools to resolve parts.

match_components

Match BOM components to the best-matching parts with confidence scoring.

find_kicad_projects

Discover local KiCad projects for BOM generation or analysis.

generate_kicad_bom

Generate a KiCad BOM from a schematic.