嘉立创 EDA MCP

嘉立创 EDA MCP 是安装在 VS Code 或 Cursor 中的用户扩展。它通过 stdio 向聊天客户端提供 MCP 工具，在 initialize 响应中内置调用顺序软约束指令，再通过桥接服务与嘉立创 EDA 侧连接器通信，实现离线文档检索、上下文读取与在线 API 调用。

适用场景

1. 在聊天中查询嘉立创 EDA API 文档。
2. 读取当前工程、页面和选区上下文。
3. 发起在线 API 调用并获取执行结果。
4. 在多页面打开场景下保持稳定桥接。

主要能力

1. 提供三个标准 MCP 工具：jlceda_api_search、jlceda_api_invoke、jlceda_context_get，工具定义从外部 JSON 文件加载，启动时自动校验格式。
2. 在 initialize 响应中内置 instructions 软约束，指导模型按"检索 → 上下文 → 调用"的顺序使用 API。
3. 提供本地桥接 WebSocket 入口（/bridge/ws）供 EDA 侧连接器接入，默认地址 ws://127.0.0.1:8765/bridge/ws。
4. 提供桥接仲裁机制：维护活动/待命角色，保证只有活动连接执行任务；活动客户端未就绪时请求进入等待队列。
5. 提供任务租约校验（leaseTerm），避免角色切换后旧回包干扰当前会话。
6. 提供桥接客户端 TTL 超时清理（8000 ms），保障异常断线后连接状态可自动恢复。
7. 提供侧边栏状态面板：展示运行状态、桥接状态与带角色标注的连接客户端列表；含 AI 自定义指令编辑卡片，支持监听地址与端口配置。
8. 提供统一结构化日志：字段级显示开关、网格化展示、固定表头、日志清空、级别与来源筛选（服务端/客户端），支持按当前字段复制日志内容。
9. 提供 WebSocket 断开详细日志：记录断开类型、发起方、关闭码、关闭原因、连接时长与发生时间。
10. 提供三项独立调试开关（系统日志/连接列表/调试控制卡片），关闭后停止对应日志发送并隐藏对应 UI。
11. 提供调试控制卡片，可在侧边栏手动启动与停止手动调试用 stdio 进程。
12. 支持 VS Code（McpServerDefinitionProvider）与 Cursor（cursor.mcp API）两类宿主接入，均通过 stdio 拉起同一运行时脚本。
13. 支持在侧边栏"AI 自定义指令"卡片或 VS Code 设置页（jlcMcpServer.agentInstructions）配置自定义 AI 助手指令；留空时仅使用系统指令，保存后重连即生效。

安装方式

从扩展商店安装

1. 打开 VS Code 扩展视图。
2. 搜索"嘉立创 EDA MCP"。
3. 也可以使用扩展 ID chengbin.jlceda-mcp-server 搜索。
4. 点击安装并按提示重载。

扩展商店页面：

VSCode 扩展商店（VSCode 端使用）： https://marketplace.visualstudio.com/items?itemName=chengbin.jlceda-mcp-server

Open VSX 扩展商店（Cursor 端使用）： https://open-vsx.org/extension/chengbin/jlceda-mcp-server

从安装包安装

1. 打开发布页：https://github.com/sengbin/JLCEDA-MCP/releases/tag/package
2. 下载 VSIX 安装包。
3. 执行 Extensions: Install from VSIX...。
4. 选择文件并完成安装。

项目地址：

https://github.com/sengbin/JLCEDA-MCP

使用前准备

1. 在嘉立创 EDA 安装 MCP 连接器。
2. 在聊天客户端启用支持 MCP 的会话能力。
3. 确保本机网络可访问 127.0.0.1 本地环回地址。

嘉立创 EDA 侧连接器说明：

请查看 ../mcp-connector/README.md

快速开始

1. 打开侧边栏并确认服务地址

1. 在活动栏打开"嘉立创 EDA MCP"。
2. 查看桥接地址，默认 ws://127.0.0.1:8765/bridge/ws。
3. 需要改端口时可在设置中修改并保存。

2. 在嘉立创 EDA 连接器中填写地址

1. 打开嘉立创 EDA 的连接设置页面。
2. 输入侧边栏显示的桥接地址。
3. 保存并等待连接状态刷新。

3. 在聊天中调用工具

1. 打开聊天面板并启用当前 MCP 服务。
2. 发起文档检索、上下文读取或 API 调用请求。
3. 在侧边栏观察运行状态、连接角色与日志变化。

可用能力

1. API 文档查询（jlceda_api_search）：通过桥接请求 EDA 侧连接器读取离线文档并检索接口名称、参数与归属，支持 scope 与 owner 过滤，最多返回 50 条。
2. 上下文读取（jlceda_context_get）：读取当前工程、文档、板框、原理图、PCB、拼版与选区信息。
3. 在线调用（jlceda_api_invoke）：通过桥接让 EDA 页面执行指定 API，支持 timeoutMs 自定义超时（1000–120000 ms）。
4. 调用软约束：模型在初始化阶段可读取内置 instructions 作为前置调用指导。
5. 自定义指令（jlcMcpServer.agentInstructions）：通过侧边栏"AI 自定义指令"卡片或 VS Code 设置页配置，内容追加在内置系统指令之后；留空时不追加任何内容，保存后重连即生效。

常见使用示例

1. 查询某个 API 的调用方式与参数顺序。
2. 读取当前选中对象并让 AI 输出结构化说明。
3. 获取当前页面上下文后再执行 API 调用。
4. 多页面并行时观察活动角色切换是否正常。

注意事项

1. 本扩展需要与 EDA 侧连接器配套安装，单独安装无法在线调用。
2. 修改监听地址后，EDA 连接器中的地址必须同步更新。
3. jlceda_api_search、jlceda_api_invoke、jlceda_context_get 均需要桥接在线。
4. 多页面同时连接时，只有活动角色执行任务，待命角色保持在线等待接管。
5. 若状态异常，建议先重载 VS Code/Cursor，再重连 EDA。
6. 自定义 AI 助手指令通过 VS Code 设置页（jlcMcpServer.agentInstructions）或侧边栏均可配置；两处同步，保存后重连即生效。

常见问题

安装后聊天里看不到工具怎么办？

请确认当前聊天会话已经信任该 MCP 服务，并且工具开关处于启用状态。

为什么文档检索和上下文读取都失败？

通常是 EDA 连接器未在线或处于异常状态，请回到 EDA 连接设置页检查连接状态。

修改端口后为什么失效？

服务端与连接器地址必须完全一致，任何一侧未更新都会导致桥接失败。