使用说明
零件MCP
用于采购具有多EDA集成的电子零件的模型上下文协议(MCP)服务器。
概述
Parts MCP使AI助手能够从流行的EDA工具中搜索电子元件、比较价格、检查可用性和处理BOM。它为组件采购工作流提供了一个统一的接口,由 源部件API.
支持的EDA工具
| 工具 | 物料清单格式 | 状态 |
|---|---|---|
| KiCad | CSV、XML | 完全支持+CLI集成 |
| Altium Designer | CSV、XLS | 完全支持 |
| Autodesk Fusion 360 | CSV | 完全支持 |
| Eagle | CSV、BRD | 全面支持 |
| PADS | CSV、ASC | 全面支持 |
| Protel 99 | CSV | 完全支持 |
特性
- 通用零件搜索:通过源部件API搜索数百万个部件
- 多EDA BOM处理:从KiCad、Altium、Fusion360、Eagle、PADS、Protel99导入BOM
- 组件匹配:基于人工智能的匹配与信心评分
- 价格比较:比较各分销商的价格
- 可用性检查:实时库存水平
- 替代零件:查找插入式替换和功能等效物
- 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+
- 源部件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桌面集成
添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %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 无需任何本地安装:
- 打开 claude.ai 在浏览器中
- 首选 设置 > 连接器
- 点击 添加自定义连接器
- 输入URL:
https://mcp.source.parts/ - 在系统提示时完成OAuth登录
- 开始在任何对话中使用零件工具
不需要API密钥——身份验证是通过OAuth处理的。
Claude代码集成
添加到您的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电阻器”
处理物料清单
“上传我的Altium物料清单,找到100台的最佳价格”
KiCad集成
“从我的放大器.kicad_sch中提取物料清单并获取所有组件”
寻找替代方案
“为过时的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原理图生成物料清单 |
建筑
MCP部件遵循瘦客户端架构:
本地(MCP):
- KiCad CLI操作
- 项目发现
- 响应缓存
- BOM文件解析
服务器(源部件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
市场列表
链接
许可证
麻省理工学院商标保护许可证-见 许可证.md
“Source Parts”是一个商标。有关使用限制,请参阅许可证。