Parts MCP

Ein Model Context Protocol (MCP) Server für die Beschaffung elektronischer Bauteile mit Multi-EDA-Integration.

Überblick

Parts MCP ermöglicht es KI-Assistenten, nach elektronischen Komponenten zu suchen, Preise zu vergleichen, die Verfügbarkeit zu prüfen und Stücklisten (BOMs) aus gängigen EDA-Tools zu verarbeiten. Es bietet eine einheitliche Schnittstelle für Workflows zur Bauteilbeschaffung, die von der Source Parts API unterstützt wird.

Unterstützte EDA-Tools

Funktionen

• Universelle Bauteilesuche: Suche in Millionen von Teilen über die Source Parts API

• Multi-EDA BOM-Verarbeitung: Import von Stücklisten aus KiCad, Altium, Fusion360, Eagle, PADS, Protel99

• Komponentenabgleich: KI-gestützter Abgleich mit Konfidenzbewertung

• Preisvergleich: Preisvergleich über verschiedene Distributoren hinweg

• Verfügbarkeitsprüfung: Echtzeit-Bestandsniveaus

• Alternative Bauteile: Suche nach Drop-in-Ersatzteilen und funktionalen Äquivalenten

• KiCad CLI-Integration: Generierung von Stücklisten direkt aus Schaltplänen

• Lokales Caching: Schnelle Antworten durch intelligentes Caching

Installation

Schnellstart (Empfohlen)

uvx parts-mcp

Keine Installation erforderlich -- uvx führt es direkt von PyPI in einer isolierten Umgebung aus.

Mit pip

pip install parts-mcp

Aus dem Quellcode

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

Anforderungen

• Python 3.10+

• Source Parts API-Schlüssel (hier erhalten)

Konfiguration

Erstellen Sie eine .env-Datei oder setzen Sie Umgebungsvariablen:

# 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

Fügen Sie dies zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

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"
      }
    }
  }
}

Bei Installation aus dem Quellcode:

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

Starten Sie nach dem Hinzufügen der Konfiguration Claude Desktop neu.

Claude.ai-Integration (Remote)

Verbinden Sie sich direkt von claude.ai ohne lokale Installation:

1. Öffnen Sie claude.ai in Ihrem Browser

2. Gehen Sie zu Einstellungen > Connectors

3. Klicken Sie auf Add custom connector

4. Geben Sie die URL ein: https://mcp.source.parts/

5. Schließen Sie die OAuth-Anmeldung ab, wenn Sie dazu aufgefordert werden

6. Beginnen Sie mit der Nutzung der Parts-Tools in jedem Gespräch

Kein API-Schlüssel erforderlich -- die Authentifizierung erfolgt über OAuth.

Claude Code-Integration

Fügen Sie dies zu Ihren Claude Code MCP-Einstellungen hinzu (~/.claude/settings.json):

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

Oder führen Sie es direkt aus:

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

Anwendungsbeispiele

Suche nach Bauteilen

"Finde einen 10k Widerstand im 0603 Gehäuse"

Verarbeitung einer Stückliste (BOM)

"Lade meine Altium-Stückliste hoch und finde die besten Preise für 100 Einheiten"

KiCad-Integration

"Extrahiere die Stückliste aus meiner amplifier.kicad_sch und beschaffe alle Komponenten"

Alternativen finden

"Finde Alternativen für den abgekündigten LM358"

Verfügbarkeit prüfen

"Prüfe die Lagerbestände für STM32F103C8T6"

Verfügbare Tools

Architektur

Parts MCP folgt einer Thin-Client-Architektur:

Lokal (MCP):

• KiCad CLI-Operationen

• Projekterkennung

• Antwort-Caching

• BOM-Dateianalyse

Server (Source Parts API):

• Komponentenabgleich

• Preisaggregation

• Bestandsprüfung

• Alternativensuche

Entwicklung

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with debug logging
DEBUG=1 python main.py

Projektstruktur

parts_mcp/
├── server.py          # MCP server entry
├── config.py          # Configuration
├── tools/             # MCP tools
├── resources/         # MCP resources
├── prompts/           # Prompt templates
└── utils/
    ├── api_client.py        # Source Parts API client
    ├── bom_parser.py        # Multi-EDA BOM parsing
    ├── component_matcher.py # Component matching
    ├── cache.py             # Response caching
    └── kicad_utils.py       # KiCad CLI integration

Marktplatz-Einträge

• MCP Registry - Offizielles MCP-Server-Verzeichnis

• Smithery - Marktplatz für die Installation mit einem Klick

• Gehosteter Server - Remote-MCP für claude.ai-Connectors

Links

• Source Parts - Plattform für Bauteilesuche

• Source Parts API Docs - API-Dokumentation

• MCP-Spezifikation - Model Context Protocol

Lizenz

MIT-Lizenz mit Markenschutz - siehe LICENSE.md

"Source Parts" ist eine Marke. Siehe Lizenz für Nutzungsbeschränkungen.