Digikey MCP

🚀 DigiKey MCP Server

FastMCPを使用したDigiKeyの製品検索API用のモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

✨ 主要特性

DigiKeyのProduct Search APIを使用したMCPサーバーで、様々な検索メソッドや製品詳細情報の取得が可能です。また、Claude Desktopとの統合もサポートしています。

📦 インストール

必要条件

• Python 3.10以上
• uvパッケージマネージャー
• DigiKey APIの認証情報（CLIENT_IDとCLIENT_SECRET）

セットアップ手順

1. 依存関係のインストール

uv sync

2. 環境変数の設定 プロジェクトのルートディレクトリに.envファイルを作成します。

CLIENT_ID=your_digikey_client_id
CLIENT_SECRET=your_digikey_client_secret
USE_SANDBOX=false

USE_SANDBOX=trueに設定すると、DigiKeyのサンドボックス環境を使用してテストできます。

3. サーバーの起動

uv run python digikey_mcp_server.py

💻 使用例

基本的な使用法

サーバーはMCPツールを公開しており、Claude DesktopなどのMCPクライアントやFastMCPクライアントを介してプログラム的に使用できます。

# 基本的なキーワード検索
keyword_search("resistor", limit=10)

# 価格でソートした検索（低い順）
keyword_search("capacitor", limit=5, sort_field="Price", sort_order="Ascending")

# フィルターを使用した検索
keyword_search("LED", limit=10, search_options="InStock,RoHSCompliant")

# 製品詳細情報の取得
product_details("296-8875-1-ND")

# 特定の数量の価格情報の取得
get_product_pricing("296-8875-1-ND", requested_quantity=100)

高度な使用法

Claude Desktopとの統合については、以下のように設定します。

macOSの場合、Claude Desktopの設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に以下の内容を追加します。

{
  "mcpServers": {
    "digikey": {
      "command": "uv",
      "args": ["run", "python", "digikey_mcp_server.py"],
      "cwd": "/path/to/project"
    }
  }
}

📚 ドキュメント

検索メソッド

• keyword_search(keywords, limit=5, manufacturer_id=None, category_id=None, search_options=None, sort_field=None, sort_order="Ascending") - ソートとフィルタリングを使用してキーワードでDigiKeyの製品を検索します。
• search_manufacturers() - すべての製品メーカーを取得します。
• search_categories() - すべての製品カテゴリを取得します。
• search_product_substitutions(product_number, limit=10, search_options=None, exclude_marketplace=False) - 代替製品を検索します。

製品詳細情報

• product_details(product_number, manufacturer_id=None, customer_id="0") - 詳細な製品情報を取得します。
• get_category_by_id(category_id) - 特定のカテゴリの詳細情報を取得します。
• get_product_media(product_number) - 製品の画像、ドキュメント、ビデオを取得します。
• get_product_pricing(product_number, customer_id="0", requested_quantity=1) - 詳細な価格情報を取得します。
• get_digi_reel_pricing(product_number, requested_quantity, customer_id="0") - DigiReelの価格情報を取得します。

keyword_searchのソートオプション

利用可能なソートフィールド：

• Packaging - 包装タイプでソートします。
• ProductStatus - 製品のステータスでソートします。
• DigiKeyProductNumber - DigiKeyの部品番号でソートします。
• ManufacturerProductNumber - メーカーの部品番号でソートします。
• Manufacturer - メーカー名でソートします。
• MinimumQuantity - 最小注文数量でソートします。
• QuantityAvailable - 利用可能な数量でソートします。
• Price - 価格でソートします。
• Supplier - サプライヤーでソートします。
• PriceManufacturerStandardPackage - メーカーの標準パッケージ価格でソートします。

ソート順：Ascending（昇順）またはDescending（降順）

検索オプション

検索メソッドで利用可能なフィルター：

• LeadFree - 鉛フリーの製品のみ
• RoHSCompliant - RoHS準拠の製品のみ
• InStock - 在庫のある製品のみ
• HasDatasheet - データシートのある製品
• HasProductPhoto - 製品写真のある製品
• Has3DModel - 3Dモデルのある製品
• NewProduct - 新製品のみ