Parts MCP

A Model Context Protocol (MCP) server for sourcing electronic parts with multi-EDA integration.

Overview

Parts MCP enables AI assistants to search for electronic components, compare prices, check availability, and process BOMs from popular EDA tools. It provides a unified interface for component sourcing workflows powered by the Source Parts API.

Supported EDA Tools

Features

• Universal Parts Search: Search millions of parts via Source Parts API
• Multi-EDA BOM Processing: Import BOMs from KiCad, Altium, Fusion360, Eagle, PADS, Protel99
• Component Matching: AI-powered matching with confidence scoring
• Price Comparison: Compare prices across distributors
• Availability Check: Real-time inventory levels
• Alternative Parts: Find drop-in replacements and functional equivalents
• KiCad CLI Integration: Generate BOMs directly from schematics
• Local Caching: Fast responses with intelligent caching

Installation

Quick Start (Recommended)

uvx parts-mcp

No install needed -- uvx runs it directly from PyPI in an isolated environment.

With pip

pip install parts-mcp

From Source

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

Requirements

• Python 3.10+
• Source Parts API key (get one here)

Configuration

Create a .env file or set environment variables:

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

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "parts": {
      "command": "uvx",
      "args": ["parts-mcp"],
      "env": {
        "SOURCE_PARTS_API_KEY": "your_api_key_here"
      }
    }
  }
}

If installed from source:

{
  "mcpServers": {
    "parts": {
      "command": "/path/to/python",
      "args": ["/path/to/parts-mcp/main.py"],
      "env": {
        "SOURCE_PARTS_API_KEY": "your_api_key_here"
      }
    }
  }
}

After adding the configuration, restart Claude Desktop.

Claude.ai Integration (Remote)

Connect directly from claude.ai without any local installation:

1. Open claude.ai in your browser
2. Go to Settings > Connectors
3. Click Add custom connector
4. Enter the URL: https://mcp.source.parts/
5. Complete the OAuth sign-in when prompted
6. Start using Parts tools in any conversation

No API key needed -- authentication is handled via OAuth.

Claude Code Integration

Add to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "parts": {
      "command": "uvx",
      "args": ["parts-mcp"],
      "env": {
        "SOURCE_PARTS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or run directly:

claude --mcp-server "python -m parts_mcp"

Usage Examples

Search for Parts

"Find a 10k resistor in 0603 package"

Process a BOM

"Upload my Altium BOM and find the best prices for 100 units"

KiCad Integration

"Extract the BOM from my amplifier.kicad_sch and source all components"

Find Alternatives

"Find alternatives for the obsolete LM358"

Check Availability

"Ch

... View full README on GitHub