Component Sourcing MCP

用于电子元器件选型、库存/阶梯价查询、资料下载和 Altium 器件库管理的 MCP Server，可接入 Codex 等 MCP 客户端。

当前版本为 v0.7.0-rc.4（预发布），Python 包版本为 0.7.0rc4。当前实现 45 个 Tool、一项 Resource 和一项 Prompt；正式 Altium/Datasheet 制造验收尚未完成。

Python 模块 szlcsc_mcp、原 CLI 别名 szlcsc-mcp 和既有 szlcsc_* 工具名保留兼容；新增 CLI 名为 component-sourcing-mcp。未来通用供应商工具会另行实现，不用立创 C 编号或 CNY 字段承载其他平台的数据。

安装

需要 Python 3.11+，主要验证环境为 Windows + Python 3.12：

git clone https://github.com/zhr1008/component-sourcing-mcp.git
Set-Location component-sourcing-mcp
py -3.12 -m venv .venv
& '.\.venv\Scripts\python.exe' -X utf8 -m pip install --index-url https://pypi.org/simple --upgrade pip
& '.\.venv\Scripts\python.exe' -X utf8 -m pip install --index-url https://pypi.org/simple -e .
& '.\.venv\Scripts\python.exe' -X utf8 -m pip check
& '.\.venv\Scripts\python.exe' -X utf8 -c "from importlib.metadata import version; print(version('component-sourcing-mcp'))"

版本检查应显示 0.7.0rc4。发布的 wheel、源码 ZIP 和校验文件见 Releases。

Related MCP server: jlcpcb-search-mcp

接入 Codex

在 ~/.codex/config.toml 中配置，替换实际路径；已有同名表时修改原表：

[mcp_servers.components]
command = 'C:\src\component-sourcing-mcp\.venv\Scripts\python.exe'
args = ['-m', 'szlcsc_mcp', '--transport', 'stdio']
cwd = 'C:\src\component-sourcing-mcp'
startup_timeout_sec = 30
tool_timeout_sec = 120

[mcp_servers.components.env]
PYTHONUTF8 = '1'
SZLCSC_REQUEST_DELAY = '0.5'
SZLCSC_EDA_REQUEST_DELAY = '0.5'

重连 MCP 后，先调用 szlcsc_cache_status 确认连接，再查料。长批量转换应拆分任务或调整 tool_timeout_sec。其他客户端配置见 mcp.example.json，详细接入与验证见 Codex 指南。

可选的本地 HTTP：

& '.\.venv\Scripts\python.exe' -X utf8 -m szlcsc_mcp --transport http --port 8000

客户端地址为 http://127.0.0.1:8000/mcp。CLI 只允许回环地址，启用 Host/Origin 防护；HTTP/SSE 没有多用户鉴权，不是公网服务。旧 SSE 客户端可使用 --transport sse 的 /sse 入口。

工具与数据

完整 45 个工具及调用边界见 skills/szlcsc/SKILL.md。Resource 为 szlcsc://sourcing-guide，Prompt 为 select_domestic_component。

szlcsc_get_part(identifier="C2040", refresh=true)
szlcsc_get_stock(identifier="C2040", refresh=true)
szlcsc_get_pricing(identifier="C2040", quantity=10, refresh=true)

国内报价使用 CNY，明确 MOQ、订购倍数、数量对应的价格阶梯；JLCPCB 装配库存与国内零售库存分别标识。缺失数据保持 null，data_freshness 记录缓存/时间信息。库存与报价默认显式刷新；上游失败不静默替换为过期采购数据。

错误使用 MCP isError=true 和结构化 error，包含 code、message、retryable 等字段。部分成功的批量结果还需检查 complete 和子项状态。服务不绕过验证码、登录、签名或访问控制。

Altium 与工程核验

默认安装提供查料、报价、资料和归档功能，不安装 Altium 解析器。Altium 集成要求 Python 3.12+，altium-monkey 用于读取/保存 SchLib/PcbLib，可显式安装：

& '.\.venv\Scripts\python.exe' -X utf8 -m pip install --index-url https://pypi.org/simple -e '.[altium]'

Altium 扩展存在尚未解决的第三方依赖漏洞：上游当前固定的 lxml/Pillow 版本命中安全公告；详见依赖安全记录。只处理可信库/图像，在独立、低权限环境中使用，暂不视为安全验收通过。基础安装不引入这组依赖。需要 EasyEDA → Altium 或 merge 时，再安装独立转换器：

powershell -ExecutionPolicy Bypass -File .\scripts\install-altium-cruncher.ps1

安装器固定 altium-cruncher==2026.9.7 到托管目录，检查原生命令退出码。MCP 依次查找显式 SZLCSC_ALTIUM_CRUNCHER、托管目录和 PATH；显式无效路径不会静默回退。

生成库会检查符号/封装关联、真实焊盘尺寸和保存后的可读取性。已有用户库的参数写回默认 dry-run，冲突保持可见，真实写回前备份。服务内文件操作串行处理，但不同进程应使用不同归档/CAD 根目录。

Datasheet 是 pin/package/footprint/electrical 最终判断依据。自动 smoke 和第三方 CAD 都不能代替投板前对 Pin 1、引脚编号、焊盘尺寸、land pattern 和 3D 方位的工程复核。

验证与贡献

& '.\.venv\Scripts\python.exe' -X utf8 -m pip install --index-url https://pypi.org/simple -e '.[dev,altium]'
& '.\.venv\Scripts\python.exe' -X utf8 -m pytest -q
& '.\.venv\Scripts\python.exe' -X utf8 scripts/check_publication_privacy.py
& '.\.venv\Scripts\python.exe' -X utf8 scripts/verify_mcp.py --all-transports

单元/Mock 与协议验证不访问上游数据。可选实时探测命令为 scripts/verify_live.py --output live-results.json，需要按报告区分 PASS、BLOCKED、FAIL 和 NOT_RUN。本地 Altium 正式验收见 验收指南；未完成验收前只发布预发布版本。

公共 CI 使用 GitHub-hosted runner，并检查完整可达历史的隐私规则。不要提交真实凭据、私人目录、原始日志或用户库。贡献与漏洞报告见 CONTRIBUTING.md 和 SECURITY.md。

本版本的独立安装、203 项测试、协议检查及联网探测范围见自动验证记录。联网测试中的 JLCPCB 访问限制和超时均单独记录，不计为数据查询成功。

许可与数据来源

本仓库自有代码使用 MIT。可选 Altium 集成的 altium-monkey 和 altium-cruncher 均声明 AGPL-3.0-or-later；包含这些功能的整体分发不能解释为全部仅受 MIT 约束。具体依赖、集成边界和分发前需确认的事项见 THIRD_PARTY_NOTICES.md。下载的 Datasheet/CAD 资产保留其上游权利。

本项目是独立社区实现，与 SZLCSC、JLCPCB、EasyEDA、Altium、Mouser、华秋和 DigiKey 无官方隶属关系。