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 连接：

在浏览器中打开 claude.ai
进入 Settings > Connectors
点击 Add custom connector
输入 URL: https://mcp.source.parts/
按照提示完成 OAuth 登录
在任何对话中开始使用 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"

使用示例

搜索元件

"Find a 10k resistor in 0603 package"

处理 BOM

"Upload my Altium BOM and find the best prices for 100 units"

KiCad 集成

"Extract the BOM from my amplifier.kicad_sch and source all components"

查找替代品

"Find alternatives for the obsolete LM358"

检查库存

"Check stock levels for 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 - 模型上下文协议

许可证

MIT 许可证，包含商标保护 - 详见 LICENSE.md

"Source Parts" 是一个商标。使用限制请参阅许可证。

Install Server

A

license - permissive license

B

quality

C

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

1wRelease cycle

11Releases (12mo)

Resources

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Source Parts MCP Server