Source Parts

Parts MCP

一个用于采购电子元件、支持多种 EDA 集成的模型上下文协议（MCP）服务。

概述

Parts MCP 可让 AI 助手搜索电子元件、比较价格、检查库存情况，并处理来自主流 EDA 工具的 BOM。它为元件采购工作流提供统一接口，由 Source Parts API 提供支持。

支持的 EDA 工具

工具	BOM 格式	状态
KiCad	CSV、XML	完全支持 + CLI 集成
Altium Designer	CSV、XLS	完全支持
Autodesk Fusion 360	CSV	完全支持
Eagle	CSV、BRD	完全支持
PADS	CSV、ASC	完全支持
Protel 99	CSV	完全支持

功能

• 通用元件搜索：通过 Source Parts API 搜索数百万种元件
• 多种 EDA BOM 处理：导入来自 KiCad、Altium、Fusion360、Eagle、PADS、Protel99 的 BOM
• 元件匹配：由 AI 驱动的匹配，并提供置信度评分
• 价格比较：比较不同分销商的价格
• 库存检查：实时库存水平
• 替代元件：查找可直接替换的元件和功能等效元件
• 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+
• Source Parts 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 Desktop 集成

将以下内容添加到 Claude Desktop 配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%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 连接：

1. 在浏览器中打开 claude.ai
2. 前往 设置 > 连接器
3. 点击 添加自定义连接器
4. 输入 URL：https://mcp.source.parts/
5. 根据提示完成 OAuth 登录
6. 即可在任意对话中使用 Parts 工具

无需 API 密钥——身份验证通过 OAuth 处理。

Claude Code 集成

将以下内容添加到 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 电阻”

处理 BOM

“上传我的 Altium BOM，并查找 100 个元件的最优价格”

KiCad 集成

“从我的 amplifier.kicad_sch 提取 BOM 并采购所有元件”

查找替代元件

“查找已停产的 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 原理图生成 BOM

架构

Parts MCP 采用轻量客户端架构：

本地（MCP）：

• KiCad CLI 操作
• 项目发现
• 响应缓存
• BOM 文件解析

服务端（Source Parts 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

市场列表

• MCP Registry - 官方 MCP 服务注册表
• Smithery - 一键安装市场
• Hosted Server - 面向 claude.ai 连接器的远程 MCP

链接

• Source Parts - 组件搜索平台
• Source Parts API Docs - API 文档
• MCP Specification - Model Context Protocol

许可证

MIT License with Trademark Protection — 详见 LICENSE.md

“Source Parts” 是商标。有关使用限制，请参阅许可证。