Source Parts

Parts MCP

複数の EDA と連携して電子部品を調達するための Model Context Protocol（MCP）サーバーです。

概要

Parts MCP を使うと、AI アシスタントは一般的な EDA ツールの BOM を処理し、電子部品の検索、価格の比較、在庫状況の確認を行えます。Source Parts API を利用し、部品調達のワークフローを統一されたインターフェースで提供します。

対応 EDA ツール

ツール	BOM 形式	状態
KiCad	CSV, XML	完全対応＋CLI 連携
Altium Designer	CSV, XLS	完全対応
Autodesk Fusion 360	CSV	完全対応
Eagle	CSV, BRD	完全対応
PADS	CSV, ASC	完全対応
Protel 99	CSV	完全対応

機能

• 汎用部品検索：Source Parts API を通じて数百万点の部品を検索
• 複数 EDA の BOM 処理：KiCad、Altium、Fusion360、Eagle、PADS、Protel99 の BOM をインポート
• 部品の照合：信頼度スコア付きの AI による照合
• 価格比較：販売代理店間の価格を比較
• 在庫状況の確認：リアルタイムの在庫数を確認
• 代替部品：そのまま置き換えられる部品や機能的に同等な部品を検索
• KiCad CLI 連携：回路図から BOM を直接生成
• ローカルキャッシュ：インテリジェントなキャッシュによる高速な応答

インストール

クイックスタート（推奨）

uvx parts-mcp

インストールは不要です。uvx が、分離された環境で PyPI から直接実行します。

pip を使用する場合

pip install parts-mcp

ソースからインストールする場合

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

要件

• Python 3.10+
• Source Parts API キー（こちらから取得）

設定

.env ファイルを作成するか、環境変数を設定します。

# 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 との連携

Claude Desktop の設定ファイルに追加します。

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

ソースからインストールした場合：

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

設定を追加したら、Claude Desktop を再起動してください。

Claude.ai との連携（リモート）

ローカルにインストールせず、claude.ai から直接接続できます。

1. ブラウザーで claude.ai を開きます
2. 設定 > コネクター に移動します
3. カスタムコネクターを追加 をクリックします
4. URL に https://mcp.source.parts/ を入力します
5. プロンプトが表示されたら、OAuth サインインを完了します
6. 任意の会話で Parts ツールを使い始めます

API キーは不要です。認証は OAuth によって処理されます。

Claude Code との連携

Claude Code の MCP 設定（~/.claude/settings.json）に追加します。

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

または、直接実行します。

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

使用例

部品を検索する

「0603 パッケージの 10k 抵抗器を探してください」

BOM を処理する

「Altium の BOM をアップロードして、100 個分の最安値を探してください」

KiCad との連携

「amplifier.kicad_sch から BOM を抽出し、すべての部品を調達してください」

代替品を探す

「廃番になった LM358 の代替品を探してください」

在庫状況を確認する

「STM32F103C8T6 の在庫数を確認してください」

利用可能なツール

ツール	説明
search_parts	クエリで部品を検索
get_part_details	部品の詳細情報を取得
get_part_pricing	販売代理店間の価格を取得
check_availability	リアルタイムの在庫状況を確認
find_alternatives	代替部品を検索
process_bom	対応する任意の EDA の BOM ファイルを処理
match_components	BOM の部品を製品と照合
find_kicad_projects	ローカルの KiCad プロジェクトを検出
generate_kicad_bom	KiCad の回路図から BOM を生成

アーキテクチャ

Parts MCP は、シンクライアントアーキテクチャを採用しています。

ローカル（MCP）：

• KiCad CLI の操作
• プロジェクトの検出
• 応答のキャッシュ
• BOM ファイルの解析

サーバー（Source Parts API）：

• 部品の照合
• 価格の集約
• 在庫の確認
• 代替品の検索

開発

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

# Run tests
pytest

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

プロジェクト構成

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

マーケットプレイスへの掲載

• MCP Registry - 公式MCPサーバーレジストリ
• Smithery - ワンクリックでインストールできるマーケットプレイス
• ホスト型サーバー - claude.ai コネクター向けリモートMCP

リンク

• Source Parts - コンポーネント検索プラットフォーム
• Source Parts API ドキュメント - API ドキュメント
• MCP Specification - Model Context Protocol

ライセンス

MIT License with Trademark Protection - 詳細はLICENSE.mdをご覧ください。

「Source Parts」は商標です。使用上の制限についてはライセンスをご覧ください。