快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

pip install --user jlcpcb-search-mcp

详细介绍

JLCPCB搜索MCP服务器

模型上下文协议（MCP）服务器，为AI助手提供JLCPCB电子元件目录的强大搜索功能。使用实时库存水平和定价搜索450000多个组件。

](https://pypi.org/project/jlcpcb-search-mcp/)

建在上面 yaqwsx/jlc部件 -非常感谢Jan Mrazek为下载JLCPCB XLS表格、将其转换为结构化JSON并为社区托管它们所做的辛勤工作！

特性

快速本地搜索：SQLite数据库，包含450K+组件，用于即时搜索
实时数据：JLCPCB API的实时库存水平和定价
智能过滤：按包装类型、类别、基本/扩展零件、最低库存进行筛选
详细信息：完整的规格、数据表、定价层次和图像
易于集成：适用于Claude Desktop、VSCode和任何兼容MCP的客户端

示例用法

向Claude自然地询问有关组件的问题：

你： “你能找到一个能支持10V或更低电压的10uF SMD电容器吗？”

克劳德的回应：

根据我的搜索，这里有一些可以支持10V或更低电压的10uF SMD电容器：

推荐选项（铝电解SMD）：

最佳选择-C4747968（RST10UF16V013）

额定值：10uF，16V
封装：贴片，D4xL5.4mm
库存：76080套（供应充足）
价格：0.0248美元（20+），0.0170美元（600+）
链接：https://jlcpcb.com/partdetail/C4747968

备选方案-C970654（RVT1C100M0405）

额定值：10uF，16V
封装：贴片，D4xL5.4mm
库存：7360件
价格：0.0293美元（20+），0.0202美元（600+）
链接：https://jlcpcb.com/partdetail/C970654

所有这些都是额定电压为16V的铝电解SMD电容器，为10V应用提供了充足的余量。由于其出色的库存水平和较低的价格，C4747968是我的首选。

注意：这些都是扩展部件（不是基本部件），因此如果您使用JLCPCB组件，它们将产生额外的组装费用。

工具

MCP服务器向您的AI助手提供四种工具：

工具	它做什么
`search_components`	在整个目录中搜索关键字。可选过滤器： `category`, `package`, `basic_only`, `min_stock`, `max_results`.
`get_component_details`	LCSC零件的完整实时详细信息——当前库存、定价级别、完整参数列表、数据表和图像。
`database_status`	报告本地数据库的位置、大小和组件计数。
`refresh_database`	从聊天中重新下载目录快照——不需要CLI。

大多数时候，你不会直接打电话给这些人；你用自然语言问克劳德（“给我找一个10k 0805的电阻器，至少有5k的库存”），它会选择合适的工具。

数据新鲜度

此服务器使用混合方法-快速搜索的本地目录快照，加上实时的API股票和定价调用。

数据	来源	新鲜度
组件目录（描述、包、属性、类别）	本地SQLite，基于以下内容构建 yaqwsx/jlc部件	上次刷新的快照
库存水平	实时JLCPCB API(`wmsc.lcsc.com`)	实时，每次查询
定价层	实时JLCPCB API	实时，每次查询
数据表URL	实时JLCPCB API	实时，每次查询

本地目录确实不自动更新。定期刷新以拾取新添加的零件、删除的零件和元数据更改：

jlcpcb-mcp-setup --refresh-db

对于大多数工作流，每周或每月刷新就足够了。库存和价格决策总是根据实时数据做出的，所以你不需要一个新的目录来信任你已经知道的零件上的数字。

安装

来自PyPI

# Install for current user (recommended for Claude Desktop)
pip install --user jlcpcb-search-mcp

# Or use pipx for isolated installation (best for CLI tools)
pipx install jlcpcb-search-mcp

# Or install in a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install jlcpcb-search-mcp

# Or install with uv in a project (uv is my fav!)
uv add jlcpcb-search-mcp

源自

git clone https://github.com/peterb154/jlcpcb-search-mcp.git
cd jlcpcb-search-mcp
pip install -e .

重要：使用Claude Code时，必须可以从项目环境访问MCP服务器：

用于紫外线项目：安装 uv add jlcpcb-search-mcp 和使用 uv run claude 命令
供全系统使用：安装 pip install --user jlcpcb-search-mcp 或 pipx install jlcpcb-search-mcp
对于venv项目：在启动编辑器之前，在您的venv中安装并激活它

快速开始

Claude代码配置

选项1：自动设置（推荐）

使用设置实用程序自动配置MCP服务器：

# For current workspace (creates .mcp.json)
# Uses shared database in user's application data directory - RECOMMENDED
jlcpcb-mcp-setup --workspace

# Or if using uv project
uv run jlcpcb-mcp-setup --workspace

# For development of THIS package only (uses ./data/ directory)
# This creates a separate 900MB+ database in your project - avoid unless needed
jlcpcb-mcp-setup --workspace --dev

# Globally for Claude Desktop (also uses shared database)
jlcpcb-mcp-setup --global

运行安装程序后：

重新加载编辑器窗口（Cmd+Shift+P→ 开发者：重新加载窗口）

检查MCP服务器是否已连接：

   # If using uv project:
   uv run claude mcp list

应该返回如下内容-请注意mcp服务器已连接：

   Checking MCP server health...

   jlcpcb-search: jlcpcb-mcp  - ✓ Connected

   # Otherwise if not using uv:
   claude mcp list

您应该看到： jlcpcb-search: jlcpcb-mcp - ✓ Connected

开始搜索组件！

选项2：手动配置

创建 .mcp.json 在您的工作区根目录中：

{
  "mcpServers": {
    "jlcpcb-search": {
      "command": "jlcpcb-mcp"
    }
  }
}

或者在Claude Desktop中进行全局配置：

macOS: ~/Library/Application Support/Claude/mcp.json 视窗: %APPDATA%\Claude\mcp.json Linux: ~/.config/claude/mcp.json

紫外线项目注意事项：同样的简单配置也有效！当你奔跑时 uv run claude，它会自动使用以下环境 jlcpcb-mcp 已安装。无需特殊配置。

首次运行和数据库设置

数据库将根据您的第一次组件搜索自动构建。 但是，您可以预先下载以避免等待：

# Pre-download the database (recommended)
jlcpcb-mcp-setup --refresh-db

# Or with uv
uv run jlcpcb-mcp-setup --refresh-db

期待什么：

下载：约50MB压缩（清单+属性查找表+每子类别约1294个分片）
最终尺寸：~1.8GB SQLite数据库未压缩（~576k个组件，1289个子类别）
时间：高速互联网连接（500Mbps）约4分钟，慢速连接约10分钟
进展：显示下载进度和子类别处理的实时更新

如果你不预先下载， 您的第一个Claude查询将自动触发下载，所以预计需要等待3-10分钟。

数据库位置

数据库是共享默认情况下，在所有项目中（推荐）：

macOS: ~/Library/Application Support/jlcpcb-mcp/components.sqlite
Linux: ~/.local/share/jlcpcb-mcp/components.sqlite
视窗: %LOCALAPPDATA%\jlcpcb-mcp\components.sqlite

为什么共享？

一个约1.8GB的数据库为您的所有项目提供服务
节省磁盘空间
更快地设置新项目
更容易保持更新

开发模式(--dev)：只有在开发jlcpcb mcp包本身时才使用此选项。它在中创建了一个单独的数据库 ./data/ 这对于测试是有用的，但浪费了正常使用的空间。

自定义位置(`JLCPCB_DATABASE_PATH`)

如果您希望数据库位于特定的位置，例如外部SSD、项目本地目录或路径，您可以 .gitignore --设置 JLCPCB_DATABASE_PATH 环境变量。值是 SQLite文件的完整路径 （不仅仅是目录）：

// .mcp.json (or your client's MCP config)
{
  "mcpServers": {
    "jlcpcb-search": {
      "command": "jlcpcb-mcp",
      "env": {
        "JLCPCB_DATABASE_PATH": "/path/to/your/components.sqlite"
      }
    }
  }
}

要预下载到该位置，请在运行安装程序之前导出相同的变量：

JLCPCB_DATABASE_PATH=/path/to/your/components.sqlite \
  jlcpcb-mcp-setup --refresh-db

或者跳过预下载，让服务器在第一个查询上构建它。

JLCPCB_DATABASE_PATH 优先于默认平台位置和 --dev 模式。

许可证

MIT许可证-有关详细信息，请参阅许可证文件

致谢

yaqwsx/jlc部件 Jan Mrazek-组件数据来源和灵感
JLC零件网络搜索 -如果你想要一个没有人工智能的优秀搜索UI
FastMCP -MCP服务器框架
JLCPCB-部件数据和API

支持

问题:
文档: docs/
MCP协议: 模型上下文协议

目录标签

PythonClaudeAI代理电子元件搜索本地部署实时库存查询AI助手集成MCP协议JLCPCB

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

工具数量（toolCount，工具数）

4

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/b1ef3b824058a9304e5404bfd13ac633

一个为AI助手提供强大搜索能力的模型上下文协议（MCP）服务器，支持实时查询JLCPCB的450,000+电子元件目录，包括库存和价格信息。

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

Jitbit Helpdesk MCP Server

An MCP server that lets AI assistants search and read support tickets from Jitbit Helpdesk. Works with both SaaS and on-premise installations. Three read-only tools: search tickets, list tickets, and get ticket with full conversation thread.

下一个 MCP

JMAP MCP Server

JMAP-MCP是一个连接器，用于与JMAP（JSON邮件访问协议）服务器交互，通过模型上下文协议（MCP）读取电子邮件。

Jlcpcb Search MCP