{
  "markdown": "<p align=\"center\">\n  <img src=\"./docs/public/landing.svg\" alt=\"EasyEDA Pro MCP\" width=\"140\" />\n</p>\n\n<h1 align=\"center\">EasyEDA Pro MCP</h1>\n\n<p align=\"center\">\n  Connect Claude, Codex, VS Code, and other Model Context Protocol (MCP) clients to the live EasyEDA Pro project already open on your machine.\n</p>\n\n<p align=\"center\">\n  Independent open-source MCP bridge for live schematic and PCB workflows in EasyEDA Pro.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/VLab-Software/easyeda_mcp/actions/workflows/ci.yml\"><img alt=\"CI\" src=\"https://img.shields.io/github/actions/workflow/status/VLab-Software/easyeda_mcp/ci.yml?branch=master&label=CI\"></a>\n  <a href=\"https://github.com/VLab-Software/easyeda_mcp/releases\"><img alt=\"Release\" src=\"https://img.shields.io/github/v/release/VLab-Software/easyeda_mcp?include_prereleases&label=release\"></a>\n  <a href=\"./LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/badge/license-MIT-blue\"></a>\n  <img alt=\"Node\" src=\"https://img.shields.io/badge/node-%3E%3D20-339933\">\n  <img alt=\"Platforms\" src=\"https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey\">\n</p>\n\n<p align=\"center\">\n  <a href=\"https://vlabsoft.org/easyeda_mcp/quick-start\">Quick Start</a>\n  ·\n  <a href=\"https://vlabsoft.org/easyeda_mcp/ai-client-setup\">AI Client Setup</a>\n  ·\n  <a href=\"https://vlabsoft.org/easyeda_mcp/tools\">Tools</a>\n  ·\n  <a href=\"https://vlabsoft.org/easyeda_mcp/troubleshooting\">Troubleshooting</a>\n  ·\n  <a href=\"https://github.com/VLab-Software/easyeda_mcp/releases\">Releases</a>\n</p>\n\n<p align=\"center\">\n  <img src=\"./docs/public/demo.gif\" alt=\"Demo showing EasyEDA Pro with the MCP Bridge workflow in action\" width=\"760\" />\n</p>\n\n## What It Does\n\nEasyEDA Pro MCP lets an AI assistant inspect the live EasyEDA Pro schematic or PCB you already have open. It gives MCP clients structured project context instead of making them guess from screenshots, copied text, or manual exports.\n\nIt runs locally:\n\n```text\nMCP client -> Node.js MCP server -> local WebSocket bridge -> EasyEDA Pro extension\n```\n\nWorks with Claude Desktop, Claude Code, Codex, VS Code, and other MCP-compatible clients.\n\n## Quick Start\n\n```bash\nnpm install\nnpm run setup:local\n```\n\nThen:\n\n1. configure your MCP client to run `node /absolute/path/to/easyeda_mcp/dist/index.js`\n2. open EasyEDA Pro\n3. load the packaged extension from `build/dist`\n4. enable external interaction permission\n5. open a schematic or PCB\n6. ask your MCP client to run `easyeda_doctor`\n\nHealthy output should show the extension connected, protocol compatible, and an active document available.\n\nFull setup guide: [Quick Start](https://vlabsoft.org/easyeda_mcp/quick-start)\n\n## What You Can Ask\n\n```text\nRun easyeda_doctor and summarize whether the EasyEDA Pro bridge is healthy.\nRun easyeda_get_context and tell me which document is open in EasyEDA Pro.\nRun easyeda_schematic_snapshot and summarize components, nets, warnings, and confidence.\nRun easyeda_trace_component for USB1 and summarize its connected nets.\n```\n\nCore capabilities:\n\n- live project and document context\n- schematic inspection for components, pins, nets, wires, and labels\n- component and net tracing\n- targeted connection assertions\n- editor navigation and export helpers\n- confirmation-gated editor-changing actions\n\n## Documentation\n\n- [Quick Start](https://vlabsoft.org/easyeda_mcp/quick-start): shortest path to a working setup\n- [Getting Started](https://vlabsoft.org/easyeda_mcp/getting-started): first-time setup with more context\n- [AI Client Setup](https://vlabsoft.org/easyeda_mcp/ai-client-setup): Claude Desktop, Codex CLI, Claude Code CLI, VS Code, and generic MCP clients\n- [EasyEDA Pro Extension Setup](https://vlabsoft.org/easyeda_mcp/easyeda-extension): install and reconnect the editor extension\n- [Tools Reference](https://vlabsoft.org/easyeda_mcp/tools): available MCP tools\n- [Troubleshooting](https://vlabsoft.org/easyeda_mcp/troubleshooting): fixes by symptom\n\n## Releases\n\nDownload packaged extension builds from [GitHub Releases](https://github.com/VLab-Software/easyeda_mcp/releases). Local builds also create `build/dist/easyeda_mcp_bridge.eext`.\n\n## Development\n\n```bash\nnpm run setup:local\nnpm test\nnpm run typecheck\nnpm run docs:build\n```\n\n`npm run setup:local` builds the MCP server, builds the EasyEDA Pro extension bundle, and packages the `.eext` artifact.\n\n## Scope, Safety, and Status\n\nThis project works against a live EasyEDA Pro session. EasyEDA Pro must be open, the local extension must be installed, and the MCP server must be running.\n\nNot included yet:\n\n- offline `.epro` parsing\n- commercial/order operations\n- unrestricted editor automation\n\nThe bridge listens on `127.0.0.1` by default. Do not expose the bridge port to untrusted networks. See [SECURITY.md](./SECURITY.md) for reporting and runtime boundaries.\n\nThis is an independent open-source project. It is not affiliated with, endorsed by, or sponsored by EasyEDA, JLCPCB, or Shenzhen Jia Chuang Ban Technology Co., Ltd.\n\n## Contact and License\n\nFeedback and suggestions: [victor.freitas@vlabsoft.com](mailto:victor.freitas@vlabsoft.com)\n\nMIT. See [LICENSE](./LICENSE).\n",
  "bytes": 5168,
  "sha": "2aa5828141d57d332b34cf40284589fa106eee2745bd514bd1d84475ab273fc8",
  "repo_slug": "vlab-software/easyeda_mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_vlab_software_easyeda_pro_mcp_1d1f3f95/readme"
}