eparts-search-mcp

DigiKey、LCSC、Mouser の電子部品を検索する MCP サーバーです。各販売代理店を個別に、またはすべてまとめて検索でき、同じ部品番号のオファーは1つのエントリに統合されるため、価格を比較できます。

ツール

search_parts は sources リストを受け取ります。省略すると設定済みのすべての販売代理店を検索し、["mouser"] を渡すとその1社だけを検索します。結果はデフォルトで部品番号ごとに統合され、cheapest_at_quantity による比較が行われます。merge=false を渡すと、各販売代理店の結果を別々のリストに保持します。

比較では、指定数量で価格が設定されているオファーのみが考慮されます。LCSC は多くの部品を10個単位で販売しているため、数量1の場合、そのようなオファーには適用可能な価格帯がなく、比較から除外されます（無料としてカウントされることはありません）。

1つの販売代理店が失敗した場合、未設定の場合、またはクォータを使い切った場合でも、他の販売代理店は結果を返し、失敗は errors の下に報告されます。

Related MCP server: Nexar MCP Server

インストール

サーバーをシステム上のどこからでも使用するには、スタンドアロンツールとしてインストールします。実行ファイルは ~/.local/bin（設定されている場合は $XDG_BIN_HOME）に配置され、依存関係は ~/.local/share/uv/tools の下の専用環境に配置されます。

uv tool install .

mise run install-tool でも同じ操作ができ、mise run uninstall-tool で削除できます。インストール後、eparts-search-mcp は任意のディレクトリから stdio でサーバーを起動し、後述の XDG 設定ファイルから認証情報を読み取ります。~/.local と ~/.config 以外には何も触れないため、特権インストール手順は不要です。

~/.local/bin が PATH に含まれていることを確認してください:

export PATH="$HOME/.local/bin:$PATH"

開発環境のセットアップ

サーバーを使用するのではなく開発する場合:

mise install
mise run install
mise run test

認証情報は設定ファイルまたは環境変数から取得できます。ファイルは認証情報を環境やプロセスリストから保護します。デフォルトでは ~/.config/eparts-search-mcp/config.toml（または設定されている場合は $XDG_CONFIG_HOME）から読み取られるため、EPARTS_CONFIG は不要です:

# ~/.config/eparts-search-mcp/config.toml
[providers.digikey]
# DigiKey: register an app at developer.digikey.com with Product Information enabled
client_id = "..."
client_secret = "..."

[providers.lcsc]
# LCSC: partner credentials issued by an account manager
key = "..."
secret = "..."

[providers.mouser]
# Mouser: request a Search API key from mouser.com/api-hub
api_key = "..."

ファイルには秘密情報が含まれるため、自分だけが読み取れるようにしてください。サーバーは起動時に、グループや他のユーザーがアクセス可能な場合に警告を表示します:

chmod 600 ~/.config/eparts-search-mcp/config.toml

同じ値は環境変数で指定することもでき、ファイルよりも優先されます:

export DIGIKEY_CLIENT_ID=...
export DIGIKEY_CLIENT_SECRET=...
export LCSC_KEY=...
export LCSC_SECRET=...
export MOUSER_API_KEY=...

実際に使用する販売代理店の認証情報のみが必要です。認証情報がないソースは、検索を失敗させるのではなく、未設定として報告されます。

認証情報の取得

DigiKey. 個人用開発者アプリではサンドボックスアクセスのみが得られ、サンドボックスは合成データを返します。実際の在庫と価格を得るには、Organization 配下にある Production アプリが必要です:

1. developer.digikey.com に DigiKey アカウントでサインインします。

2. ナビゲーションバーの Organizations を開き、まだメンバーでない場合は作成します。

3. Operations の下で Production Apps を選択し、Create Production App をクリックします。

4. アプリで Product Information を有効にします。

5. アプリを開いて Client ID と Client Secret をコピーします。

OAuth コールバックフィールドは、3-legged OAuth でのみ使用されます。このサーバーは2-legged のクライアント認証情報フローを使用するため、コールバックがリダイレクトされることはありません。https://localhost でフォームを満たせます。

サンドボックスと本番の認証情報は互換性がありません。サンドボックス認証情報は sandbox-api.digikey.com に対してのみ機能し、DIGIKEY_SANDBOX=true で選択されます。

LCSC. Open API はセルフサービス登録ではなくパートナー統合であるため、認証情報は呼び出し元 IP アドレスがホワイトリストに登録された後、LCSC のアカウントマネージャーから提供されます。オンボーディングは、シミュレートされたカタログデータを返す別ホスト（fatapi.lcsc.com）のテスト環境で開始されます。LCSC_SANDBOX=true で選択されます。統合が承認されると本番認証情報が届き、api.lcsc.com に対して使用されます。

呼び出しは、リクエストパラメータ、キー、リクエストごとの nonce、タイムスタンプに対する SHA-256 署名で認証されます。シークレットはそのハッシュへの入力であり、送信されることはないため、URL やログに表示されることはありません。タイムスタンプはチェックされるため、システムクロックが大きくずれていると、キーが拒否されたのではなく、期限切れのリクエストとして扱われます。

Mouser. mouser.com/api-hub で Search API キーをリクエストします。これは単一のキーで、クエリパラメータとして送信され、メールで届きます。

MCP クライアント設定

上記のようにインストールすると、コマンドは PATH に含まれ、認証情報は設定ファイルから取得されるため、パスや環境変数は不要です:

{
  "mcpServers": {
    "eparts-search-mcp": {
      "command": "eparts-search-mcp"
    }
  }
}

一部のクライアントは、~/.local/bin を含まない最小限の環境でサーバーを起動します。その場合は絶対パスを指定してください:

{
  "mcpServers": {
    "eparts-search-mcp": {
      "command": "/home/you/.local/bin/eparts-search-mcp"
    }
  }
}

ソースチェックアウトからインストールせずに実行する場合、または認証情報を設定ファイルではなくクライアント経由で渡す場合:

{
  "mcpServers": {
    "eparts-search-mcp": {
      "command": "/path/to/eparts-search-mcp/.venv/bin/python",
      "args": ["-m", "eparts_search_mcp"],
      "env": {
        "DIGIKEY_CLIENT_ID": "...",
        "DIGIKEY_CLIENT_SECRET": "...",
        "MOUSER_API_KEY": "..."
      }
    }
  }
}

レート制限

各販売代理店は1日あたり約1000回の呼び出しを許可しているため、すべてのリクエストは予算化されています。1秒あたりおよび1分あたりのウィンドウは待機によって強制されます。1日あたりのウィンドウはハードストップであり、呼び出し側が深夜にリセットされるクォータを待つことはできないため、代わりにエラーを報告します。1日あたりのカウンタは永続化されるため、サーバーを再起動してもリセットされません。

デフォルト:

LCSC は1分あたり60回のキーワード検索と1日あたり1000回を文書化しており、成功した呼び出しのみをカウントします。1分あたりのデフォルトは文書化された上限より低く設定されています。これは、販売代理店によるスロットリングがローカルでの待機よりもコストがかかるためです。LCSC 自身のカウンタが呼び出しを拒否した場合、エラーはその旨を明示し、ローカル予算と区別します。

すべての値は、環境変数または TOML ファイルによってプロバイダーごとに設定可能です。none、off、unlimited、または 0 を使用してウィンドウを無効にします:

export DIGIKEY_RATE_PER_DAY=250
export DIGIKEY_RATE_PER_MINUTE=30
export LCSC_RATE_PER_MINUTE=20
export MOUSER_RATE_PER_SECOND=none
export MOUSER_RATE_BURST=5
export MOUSER_RATE_MAX_WAIT=30

これらは設定ファイル（デフォルトでは ~/.config/eparts-search-mcp/config.toml、または EPARTS_CONFIG が指す場所）にも格納されます。config.example.toml を参照してください。環境変数はファイルより優先されるため、クライアントの起動コマンドでディスク上の設定を編集せずに制限を調整できます。

キャッシュされたレスポンスは予算を消費せずに提供されます。source_status はその日の残りを報告します。

その他の設定

ディスク上のファイル

サーバーが保持するすべてのものは XDG ベースディレクトリの下に置かれるため、インストールはホームディレクトリの外には何も所有しません:

XDG_CONFIG_HOME と XDG_STATE_HOME は、未設定の場合それぞれ ~/.config と ~/.local/state にデフォルト設定されます。EPARTS_CONFIG と EPARTS_CACHE_PATH は最後の2つを上書きします。uv tool uninstall eparts-search-mcp でアンインストールしても、設定とキャッシュは残ります。それらも削除するには、それらのディレクトリを削除してください。

アーキテクチャ

classDiagram
    class MCPServer {
        search_parts(keyword, sources, merge)
        part_details(part_number, sources)
        source_status()
        clear_cache(source)
    }
    class SearchService {
        +providers: dict
        +limiters: dict
        +resolve_sources(sources)
        +search(...) SearchResult
        +details(...) list~Part~
    }
    class Provider {
        <<abstract>>
        +name: str
        +configured: bool
        +search(...) list~Part~
        +details(...) Part
        #_cached_request(...)
    }
    class DigiKeyProvider {
        -_token: str
        -_access_token()
        -_manufacturer_filter_id(name)
        -_pick_variation(product)
    }
    class LCSCProvider {
        -_headers(payload)
        -_to_part(entry)
        +sign(payload, key, secret, nonce, timestamp)
    }
    class MouserProvider {
        -_parse_response(response)
        +parse_price(raw)
    }
    class RateLimiter {
        +acquire()
        +remaining_today()
    }
    class Cache {
        +get(key)
        +set(key, provider, value, ttl)
        +get_daily_usage(provider, day)
        +increment_daily_usage(provider, day)
    }
    class Part {
        +source, mpn, manufacturer
        +stock, price_breaks, specs
        +unit_price_at(quantity)
    }
    class MergedPart {
        +mpn
        +offers: list~Part~
        +sources
    }

    MCPServer --> SearchService
    SearchService --> Provider
    SearchService --> RateLimiter
    SearchService --> Cache
    Provider <|-- DigiKeyProvider
    Provider <|-- LCSCProvider
    Provider <|-- MouserProvider
    Provider --> RateLimiter : acquire before call
    Provider --> Cache : read before spending budget
    RateLimiter --> Cache : persist daily counter
    Provider --> Part : produces
    MergedPart o-- Part : groups offers by part number

1つのプロバイダー呼び出しのリクエストフロー:

sequenceDiagram
    participant C as MCP client
    participant S as SearchService
    participant P as Provider
    participant K as Cache
    participant L as RateLimiter
    participant A as Distributor API

    C->>S: search_parts(keyword, sources)
    S->>S: resolve_sources
    par each source
        S->>P: search(keyword)
        P->>K: get(key)
        alt cached
            K-->>P: payload
        else not cached
            P->>L: acquire()
            alt budget available
                L-->>P: ok
                P->>A: HTTP request
                A-->>P: response
                P->>K: set(key, payload)
            else daily quota spent
                L--)P: RateLimitExceeded
            end
        end
        P-->>S: parts or error
    end
    S->>S: merge by part number
    S-->>C: results plus per source errors

3つの API に関する注意点

DigiKey は OAuth2 クライアント認証情報を使用します。トークンは10分間有効で、メモリにキャッシュされます。リクエストにはベアラートークンとともにクライアント ID ヘッダーが必要です。フィルタは不透明な ID として表現されるため、メーカー名はまず manufacturers エンドポイントを通じて解決されます。

LCSC はトークンを保持する代わりに各リクエストに署名します。キー、nonce、タイムスタンプ、ソートされたクエリパラメータがシークレットでハッシュされ、ダイジェストがヘッダーで送信されます。Mouser と同様に、リクエストが失敗しても HTTP 200 で応答し、実際の結果はボディの code フィールドに格納されます。アダプタはこれを信頼できるものとして扱います。部品ごとのエンドポイントがないため、詳細検索はキーワード検索であり、そこから完全一致が選ばれます。完全一致のみを返すキーワード検索では、もっともらしい誤った結果ではなく、結果なしとなります。メーカーフィルタもないため、メーカーはキーワードに組み込まれ、結果は戻り際にフィルタリングされます。

Mouser はクエリパラメータとして渡される API キーを使用し、リクエストが失敗しても HTTP 200 で応答し、失敗を Errors 配列に格納します。アダプタはその配列を信頼できるものとして扱います。価格は数値ではなく、ローカライズされた表示文字列として届きます。

パラメトリック仕様は3つの販売代理店間で共通の語彙がないため、共通スキーマに正規化するのではなく、名前と値のマップとしてそのまま渡されます。LCSC のリール追加料金も同様に報告されます。これは注文ごとの手数料であり、単価ラダーでは表現できないためです。

このツールの作成には Claude Code が使用されました。