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