JinDaGe - digikey_mcp MCP Details

article

README

🚀 DigiKey MCP Server

DigiKey MCP Server 是一个基于 FastMCP 构建的模型上下文协议（MCP）服务器，可用于 DigiKey 的产品搜索 API。它为开发者提供了便捷的方式来搜索和获取 DigiKey 产品的详细信息。

🚀 快速开始

✨ 主要特性

提供多种搜索方法，支持按关键词、制造商、类别等进行搜索。
可获取产品的详细信息，包括定价、媒体资料等。
支持排序和过滤功能，方便用户精准查找所需产品。
可与 Claude Desktop 集成，实现更便捷的使用体验。

📦 安装指南

1. 安装依赖

uv sync

2. 设置环境变量

在项目根目录下创建一个 .env 文件，并添加以下内容：

CLIENT_ID=your_digikey_client_id
CLIENT_SECRET=your_digikey_client_secret
USE_SANDBOX=false

若要使用 DigiKey 的沙盒环境进行测试，请将 USE_SANDBOX 设置为 true。

3. 启动服务器

uv run python digikey_mcp_server.py

💻 使用示例

基础用法

# 基本关键词搜索
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)

📚 详细文档

可用工具

搜索方法

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 - 仅搜索新产品。

Claude Desktop 集成

将以下内容添加到你的 Claude Desktop 配置文件（在 macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）中：

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

digikey_mcp