Proteus MCP
This server exposes MCP tools for automating Proteus EDA workflows, from device lookup and schematic/PCB editing to native project verification, C51 firmware builds, and simulation.
Search and inspect installed Proteus
.LIBdevices, pins, hidden supplies, properties, and multi-unit packaging.Create and manage semantic circuit projects: add/set/remove components, connect pins, batch-edit atomically, validate model connectivity, and export plans/netlists/SVG previews.
Generate, export, inspect, and preview native
.pdsprjfiles, including calibrated component geometry and topology readback.Open, save, close, reopen, and diagnose Proteus projects; inspect runtime process/window/menu state and native commands.
Read and edit live ISIS schematic sheets using native functions, with token checks and undo/redo for MCP edit batches.
Run native ERC, physical DRC, and preproduction checks; read PCB data and route TOP/BOT traces with through-vias, including bounded push/shove planning/apply.
Export audited CSV/JSON BOMs from saved native projects.
Build Keil C51 firmware, inspect Intel HEX, and create example 8051 circuits such as LED chaser and external interrupt demos.
Control simulation run/pause/stop, read logs, sample nets, stimulate BUTTON/LOGICSTATE inputs, observe digital signals, and decode multiplexed seven-segment displays.
Check capability-specific health and installation status; note the server is experimental and many tools explicitly avoid claiming full verification where not guaranteed.
Invokes a locally installed Keil C51 toolchain (C51.exe, BL51.exe, OH51.exe) to compile 8051 firmware for the simulated microcontroller circuits, then verifies results alongside simulation evidence.
Integrates with Labcenter Proteus 9 via a version-locked native bridge to search device libraries, build and edit schematics, route PCBs, run ERC/DRC and pre-production checks, export BOMs, and drive simulation—opening/saving projects, running/pausing/stopping the simulator, and sampling digital nets and seven-segment displays.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Proteus MCP Find the AT89C51 in my Proteus library and show its pinout."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Proteus MCP
面向 AI Agent 的 Proteus 通用操作接口,目标是逐步开放 Proteus 的各项能力,让 Agent 能够直接使用 Proteus 完成电子设计工作。
安装 · 客户端配置 · 使用示例 · 工具参考 · 问题反馈
当前支持
功能 | 支持内容 |
器件库 | 搜索本机 |
原理图 | 器件放置、旋转与镜像、自动布局、正交连线、汇接点及 |
当前工程 | 在 MCP 启动的会话中添加、连接、移动和删除器件,修改属性,撤销与重做 |
PCB | TOP/BOT 双层布线、通孔换层,以及已校准路径的有界推挤 |
检查与输出 | 原生 ERC、物理间距 DRC、预生产检查和 CSV/JSON BOM |
固件与仿真 | Keil C51 编译、仿真启停、数字网络采样、BUTTON/LOGICSTATE 激励和四位数码管解码 |
完整接口见工具参考,器件、布线和仿真的支持范围见兼容性与限制。
Related MCP server: jlc-mcp
安装
Python 3.11 或更新版本。
原生功能需要 Windows 10/11 和兼容的 Proteus 安装。
编译 C51 程序时需要 Keil C51。
在 PowerShell 中执行:
git clone https://github.com/chen0416ccc-cpu/Proteus-MCP.git D:\Projects\Proteus-MCP
cd D:\Projects\Proteus-MCP
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[bridge]"仅使用器件库查询和语义模型时,可将安装命令中的 ".[bridge]" 改为 .。Release wheel 安装方法见安装文档。
安装后可先检查环境并准备本机资源:
.\.venv\Scripts\python.exe -m proteus_mcp doctor
.\.venv\Scripts\python.exe -m proteus_mcp setupProteus、器件库和 Keil 路径通常自动识别。首次导出会自动完成本机初始化,无需手工放置校准器件;需要安装中带有可识别的 Proteus 9 样例资源。初始化不下载或分发商业库。详见安装文档。
客户端配置
以 Codex 的 config.toml 为例,将路径改为本机安装位置:
[mcp_servers.proteus]
command = 'D:\Projects\Proteus-MCP\.venv\Scripts\python.exe'
args = ["-X", "utf8", "-m", "proteus_mcp", "serve"]
[mcp_servers.proteus.env]
PROTEUS_MCP_WORKSPACE = 'D:\ProteusWork'
# 自动发现不符合预期时再配置:
# PROTEUS_MCP_EXE = 'C:\Program Files\Labcenter Electronics\Proteus 9 Professional\Bin\PDS.exe'
# PROTEUS_MCP_LIBRARY = 'C:\ProgramData\Labcenter Electronics\Proteus 9 Professional\Library'
# PROTEUS_MCP_KEIL = 'C:\Keil_v5'启动 MCP 服务后,调用 proteus_doctor 查看实际选中的安装、初始化状态和各项原生能力的兼容性。多套 Proteus 共存或使用便携安装时,可显式指定路径。
Claude Desktop 等 stdio 客户端的 JSON 配置见客户端配置。
使用示例
查询器件
在本机器件库中查找 NE555,列出它的物理引脚、默认参数和所在库。绘制电路
新建一个 NE555 无稳态振荡器,定时电阻为 10 kΩ 和 100 kΩ,定时电容为 10 µF。
按定时网络和输出负载分区布局,导出 Proteus 工程并打开。查看连接
读取当前 MCP 会话的电路,列出 U1 各引脚所连接的网络和器件。运行仿真
运行已打开工程的仿真,采样 OUT 网络 10 秒,显示数字电平的变化。工具调用参数、C51 流水灯和外部中断示例见示例文档。
文档
文档 | 内容 |
环境变量、客户端配置和常见问题 | |
自动准备、原生校验与高级覆盖 | |
参数、返回值和会话操作 | |
自动布局、固定位置、纸张与连线检查 | |
支持的构建、器件、PCB 和仿真范围 | |
文件格式、原生桥和模块结构 |
开发与测试
python scripts/run_tests.py --profile portable
python scripts/check_release.py许可证
代码采用 MIT 许可证。Proteus、Keil 及其商业资源需另行获取,不包含在本仓库中。
Proteus MCP 为非官方项目,与 Labcenter Electronics、Arm/Keil 无隶属关系。第三方说明见 NOTICE.md。
Available Tools
53 toolscatalog_listBRead-only
List supported logical devices and pins; library_path explicitly selects ambiguous installed devices. NOT placement verification.
Inputs: device, library_path.
circuit_editADestructive
Apply an atomic revision-checked batch: add, set (properties/position), remove, connect, disconnect, merge_nets. Any invalid edit rolls back the entire batch. Export native afterward.
Inputs: project (required), operations (required), expected_revision (required).
component_addBDestructive
Add a logical component; does NOT draw in Proteus. Use current expected_revision.
Inputs: ref (required), device (required), project (required), position (required), +5 more.
component_setCDestructive
Update logical properties or placement; native status becomes not_applied.
Inputs: ref (required), project (required), properties (required), expected_revision (required), +3 more.
connect_pinsCDestructive
Connect named pins in the model, e.g. U1.P1.0 to D1.K. Rejects implicit shorts across nets.
Inputs: name (required), pins (required), project (required), expected_revision (required).
example_external_interruptADestructive
Create a NEW C51 teaching circuit/source for external interrupts: two BUTTON inputs, 8 LEDs, multiplexed 4-digit CC display and transistor-driven buzzer. mode=level: idle chaser, held low-level input increments with alarm; mode=nesting: low-priority INT0 chaser can be preempted by high-priority INT1 increment. Diagnostic nets expose ISR activity/increment/wrap. initial_count defaults to 0000; other values support explicit boundary tests. Build/export/open/observe separately. Not physical driver or audio certification.
Inputs: project (required), mode, initial_count.
example_led_chaserCDestructive
Create a NEW 12MHz 12T 8051, P1 active-low 8-LED circuit and C51 main.c.
Inputs: project (required).
export_netlistBDestructive
Export portable semantic netlist.json, NOT an importable Proteus native file.
Inputs: project (required).
export_svgCDestructive
Export named-net connectivity preview.svg. This is NOT a Proteus screenshot or .pdsprj.
Inputs: project (required).
firmware_buildBDestructive
Actually run installed C51, BL51 and OH51; preserve logs and verify Intel HEX. NOT simulation.
Inputs: project (required).
firmware_inspectBRead-only
Read Intel HEX and validate checksums, addresses, overlap and reset vector.
Inputs: path (required).
library_deviceBRead-only
Read real installed device pins, geometry, hidden supplies, properties and source library. Optional explicit unit A..Z resolves supported homogeneous multi-unit packaging to physical pin numbers.
Inputs: device (required), unit, library_path.
library_searchBRead-only
Search the actual installed Proteus .LIB device index without mouse or screenshots. Finding a device does not imply native placement support.
Inputs: query (required), limit.
live_editADestructive
Edit the CURRENT owned ISIS sheet in the same PID/document using native functions. Stopped simulation and current live_read token required. Operations: add, transform, set, connect. Deletion is a separate batch: {op:delete,ref,delete_connected_wires:false} permits direct attached component wires only when true; {op:delete_wire,wire_address} removes one exact wire including a branch; {op:delete_junction,junction_address,connected_wire_addresses:[all exact incident addresses]} removes a DOT and explicitly listed incident wires, never a whole net. Non-target geometry/labels are compared; native selections/tags are rejected. NOT atomic; partial/unconfirmed may have applied. Save/reopen for disk validation.
Inputs: session (required), operations (required), expected_token (required).
live_historyADestructive
Undo or redo exactly one recorded MCP live_edit batch in the same native document. Requires current live_read token, stopped simulation and matching semantic history. External edits, no-op or partial batches invalidate history. Does not emulate keyboard input.
Inputs: action (required), session (required), expected_token (required).
live_readARead-only
Read CURRENT owned ISIS sheet components, physical pin numbers/names, transforms and real wires. Returns revision token. No screenshots or input emulation.
Inputs: session (required).
manufacturing_bomADestructive
Export an audited UTF-8 CSV and JSON assembly BOM from a SAVED, DSN/CDB-consistent native project. Requires input SHA-256, counts each physical package once across units, reports unassigned packages separately, escapes CSV formulas, writes NEW workspace output only. Not unsaved-session data, Gerber/Excellon, verified PCB population or fabrication certification.
Inputs: path (required), expected_sha256 (required).
native_applyBDestructive
Export the semantic circuit into a NEW native file with full signal wires and strict sheet bounds, never silent label fallback. The LED example uses authored parallel channels. Does not modify a live session. Use project_open on its returned path.
Inputs: project (required).
native_checkADestructive
Run a stopped-session native check. kind=erc requires a live_read token and a fresh electrical report. kind=drc requires a pcb_read token and refreshes the whole-design ARES physical clearance checker, reading real violations/ignored flags without a dialog. kind=preproduction runs all 23 native PPC checks, including connectivity CRC, on an owned workspace copy with a pcb_read token; restores original selections and closes only its own native PPC dialog. Cached/truncated/partial/disabled results, warnings, skips and ignored violations never count as clean. Current configured rules only, NOT fabrication certification or unrestricted full PCB DRC. Invocation status is separate from passed.
Inputs: session (required), expected_token (required), kind.
native_commandsBRead-only
Discover native command IDs, owning modules, labels and enabled/checked states. Discovery is NOT verified execution. No arbitrary command execution is exposed.
Inputs: session (required), query, module.
native_createADestructive
Create a NEW experimental empty native .pdsprj within an existing semantic project. No UI input. Use project_open/save to verify the generated instance.
Inputs: project (required).
native_exportCDestructive
Draw a NEW native schematic with calibrated symbols, rotation and mirroring. Default auto uses full continuous signal wires and sheet bounds, never silently falls back to labels. The LED example uses an authored parallel-channel plan. Explicit labels and wires modes remain opt-in and are also sheet-bounded. routing=schematic uses exact half-grid trees and audited unconnected crossings; sheet_size sets even grid width/height. Topology readback; never overwrites a project.
Inputs: project (required), layout, routing, wire_plan, +2 more.
native_export_led_chaserBDestructive
Generate a native .pdsprj, C51 source and HEX from the exact example_led_chaser topology. Calibrated explicit wires and named nets. Each export still needs its own runtime verification.
Inputs: project (required).
native_inspectBRead-only
Read .pdsprj ZIP contents and hashes. Does NOT claim electrical verification.
Inputs: path (required).
native_previewCDestructive
Render an SVG from actual calibrated native component/pin/wire/junction geometry. This is a reconstructed vector preview, not a screenshot. New output only.
Inputs: path (required), output.
native_readBRead-only
Read calibrated native components, properties and stored pin references directly from .pdsprj. No UI. Not simulation verification.
Inputs: path (required).
native_set_componentBDestructive
Modify calibrated native component values, clock_hz or program in a NEW output file, requiring source SHA-256. No UI; never overwrites output.
Inputs: ref (required), path (required), output (required), properties (required), +1 more.
native_statusBRead-only
Read commands, logs, modal dialog and simulation state via version-pinned Qt function bridge. Optional Frida; no input emulation.
Inputs: session (required).
native_verifyCDestructive
Autonomously open, save, close, reopen, compare circuit/cache, run and sample, pause/resume/stop, close and collect crash evidence. Net order is checked for calibrated active-low cyclic output. Creates file backups and reports.
Inputs: path (required), nets, seconds.
pcb_readARead-only
Export and read the CURRENT owned ARES PCB: native pad indices, nets, layers, board outline, rules, copper paths and calibrated through-vias including native drill/style/span. Stopped simulation required. Returns revision token; pad indices are NOT schematic physical pin numbers.
Inputs: session (required).
pcb_routeADestructive
Add verified real TOP/BOT same-layer copper in the owned ARES board, preserving old wires and calibrated vias. Token, existing net and two native pad ids required. Explicit points_nm or conservative 8-direction A*. All pad/copper/via/edge clearance checked. Integer nm must be 10 nm aligned. Not full DRC or push/shove. Unknown geometry fails closed; NOT atomic. Save/reopen verifies disk copper.
Inputs: net (required), layer (required), to_pad (required), session (required), +6 more.
pcb_route_layersADestructive
Route between real through-hole pads across TOP/BOT with full-diameter calibrated through-vias. Requires fresh pcb_read token and native via_style. Automatic layer-state A* or explicit waypoints of {layer,position_nm}; a layer change repeats the same position. Preserves all old wires/vias and verifies exact native copper, style, hole, span and multiplicity. Only two-copper-layer rectangular boards with known geometry. NOT push/shove, blind/buried vias, full DRC or atomic. Save/reopen for disk verification.
Inputs: net (required), to_pad (required), session (required), from_pad (required), +9 more.
pcb_route_pushADestructive
Bounded local push of ONE isolated MCP-created trace on TOP/BOT to clear an explicit new pad-to-pad path. mode=plan (default) does NOT change copper; mode=apply displaces an internal orthogonal segment, fixes both old pad endpoints, imports exact replacements and requires a fresh clean native clearance DRC. Supply current pcb_read token and explicit movable wire_ids from wire_inventory. No branches, via moves, cascades, arbitrary native/protected traces, native lock certification, or vendor interactive push engine. Non-atomic; an unconfirmed apply may have changed the board. Save/reopen for disk verification.
Inputs: net (required), layer (required), to_pad (required), session (required), +9 more.
pcb_route_push_chainADestructive
Plan/apply bounded multi-trace chain displacement on TOP/BOT. Up to eight explicitly allowed, current MCP-created isolated pad-to-pad traces may move internal orthogonal segments; fixed anchors and all other copper/vias are preserved. mode=plan is read-only, apply requires exact replacement and fresh native DRC. Not the vendor interactive engine; branch/via push and arbitrary locked traces remain unsupported. NOT atomic. Save/reopen for disk verification.
Inputs: net (required), layer (required), to_pad (required), session (required), +9 more.
project_closeADestructive
Request normal WM_CLOSE for a tracked Proteus session. Does not force termination or dismiss unsaved-change dialogs.
Inputs: session (required).
project_createBDestructive
Create a NEW semantic circuit directory; never overwrite existing directories.
Inputs: project (required).
project_openADestructive
Open a .pdsprj directly, return once the project window settles, record processes and crash evidence. With session, reuse the same project or stop/save/close that owned session before switching files. No input emulation.
Inputs: path (required), session, wait_seconds.
project_planBDestructive
Export deterministic plan.json. Status is planned, not applied to Proteus.
Inputs: project (required).
project_readCRead-only
Read circuit revision and source hash.
Inputs: project (required).
project_reopenADestructive
Save, verify circuit preservation, close normally, then reopen the same tracked project. Stops if saving or normal close is unconfirmed.
Inputs: session (required).
project_saveADestructive
Queue native Save Project; back up and verify the scoped save. Confirm only the exact calibrated format-upgrade notice for workspace copies, never unknown dialogs. Schematic save compares disk circuit/cache; PCB save checks memory plus archive write and needs project_reopen for disk copper verification. No keyboard/mouse.
Inputs: session (required).
project_validateARead-only
Check model pin existence, MCU supplies/reset and floating passive pins. NOT full ERC.
Inputs: project (required).
proteus_doctorARead-only
Report capability-specific health. Installed is not verified working.
Inputs: no named parameters.
runtime_diagnosticsBDestructive
Collect Windows crash events, dump paths and process state for a tracked launch, saving diagnostics.json.
Inputs: session (required).
runtime_statusBRead-only
Read running Proteus process, window and menu metadata. No screenshots or input emulation.
Inputs: session.
simulation_controlBDestructive
Execute run, pause or stop using version-pinned Qt functions for an owned runtime session, then check native command state. A semantic project alone is insufficient.
Inputs: action (required), project, session.
simulation_decode_displayADestructive
Decode a saved raw simulation_observe/stimulate JSON trace by actual segment/select net values. Supply source SHA-256, ordered A..G[,DP] segment_nets and left-to-right digit_nets. Requires exactly one selected digit and known stable states; reports composite frames, confirmations and rejected samples. This is sampled digital evidence, not optical output or complete transitions.
Inputs: digit_nets (required), trace_path (required), segment_nets (required), expected_sha256 (required), +3 more.
simulation_inputsARead-only
Read calibrated BUTTON/LOGICSTATE inputs in an owned RUNNING ISIS simulation. Returns epoch/context/EID-bound token. Start with simulation_control; restart invalidates old tokens. No desktop input.
Inputs: session (required).
simulation_logBRead-only
Read actual Proteus simulation log rows directly from the native item model. No menu, screenshots or input emulation.
Inputs: session (required).
simulation_observeADestructive
Sample DSIM native network vectors with VSMDEBUG native simulation-time brackets. Strength-aware decoding only for calibrated state codes; unknowns remain unknown. Bounded polling, NOT a complete event waveform or analog/audio measurement. Saves full raw trace, returns summary/evidence. Running owned session only.
Inputs: nets (required), session (required), wall_ms, interval_ms, +1 more.
simulation_sampleBDestructive
Sample live native DSIM network STATE values and save evidence. Supply native network names, not semantic JSON net names. Raw states include strength bits.
Inputs: nets (required), session (required), seconds, interval_ms.
simulation_stimulateADestructive
Deliver 1..32 calibrated native input events using a current simulation_inputs token. at_ms is a nondecreasing offset from the current native simulator time. Waits for actual time then dispatches at CURRENT time and records lateness. Delivery delays shift following events enough to preserve requested inter-event spacing, never compress a pulse or inject future events. Native clock is coarse, not hard realtime. BUTTON 0=release/1=press; LOGICSTATE 0=low/1=high. Runtime events only: persistent STATE/icon/disk is not edited. Non-atomic; partial/unconfirmed may have applied; no automatic restore. Dispatched does NOT prove electrical effect or ISR behavior. Saves complete sampled raw trace.
Inputs: nets (required), events (required), session (required), expected_token (required), +2 more.
source_writeADestructive
Write main.c; existing source requires matching expected_sha256 and is backed up.
Inputs: source (required), project (required), expected_sha256.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 53 tools
Several tools target nearly identical territory and only deep description-reading separates them: native_read vs native_inspect vs live_read vs project_read all 'read the native project', simulation_sample vs simulation_observe vs simulation_log all sample simulator data, and four pcb_route* variants plus native_export vs native_apply vs native_export_led_chaser vs example_led_chaser are near-siblings. The detailed descriptions do provide the distinctions, but with 53 tools an agent is likely to misselect on the first pass (e.g. component_add vs circuit_edit vs live_edit vs native_set_component).
There is a systematic noun_verb prefix scheme (project_*, native_*, pcb_*, simulation_*, library_*, component_*, firmware_*), which is readable and groups well. But it mixes conventions with verb_noun outliers like connect_pins, export_svg, export_netlist, source_write, live_history, and one-off names like proteus_doctor and example_external_interrupt.
53 tools is far beyond a comfortable agent-facing surface, even for a broad proteus-automation domain spanning schematic, native file, PCB, simulation and manufacturing. Distinct capabilities here (e.g. four routing tools, three read tools, three status/diagnostic tools) could plausibly be consolidated into a single operation-dispatched tool.
Coverage is unusually deep: create/read/edit/validate/save/close/reopen for projects, add/set/connect/delete for circuits, plus exports, firmware build/inspect, simulation control/stimulus/observe, PCB read/route, and BOM. Minor gaps exist (no project delete/cleanup, explicitly no full ERC or Gerber/fabrication outputs), but these are declared boundaries rather than dead ends.
Maintenance
Related MCP Connectors
Design circuits, simulate and verify embedded firmware, and lay out PCBs with AI agents.
Design and revise PCBs from plain language, track jobs, and retrieve design artifacts.
Hosted MCP server for live public-data APIs and Skills for AI agents.
EasyGerber brings AI printed circuit board (PCB) design, layout, and routing to MCP-compatible assistants. Describe a circuit or start from firmware pin assignments, search published electronic components, and build schematics using catalog parts with their footprints and available 3D models. Create and revise boards, generate layouts with automatic component placement and routing, inspect previews, and check saved layouts for blocking design issues. Export manufacturing ZIPs containing Gerber and drill files, a bill of materials, and component placement data, or download an editable EasyGerber (.egb) file. Start without signing up. Your agent uses one private board reference to create and continue a board, including catalog access, edits, layout, checks, previews, and exports, without a separate guest setup step or token to manage. To keep the board in your account or work with permitted saved personal or organization boards, complete EasyGerber sign-in and OAuth consent, then resume the same task. Account permissions, plan limits, and generation billing apply; support depends on your MCP client and installed integration.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents end-to-end control of KiCad 9+ for rule checks, manufacturing exports, production-readiness certification, and live PCB editor control.MIT
- AlicenseNot gradedqualityDmaintenanceLocal Model Context Protocol server that exposes EasyEDA Pro design capabilities as MCP tools, enabling project inspection, schematic editing, PCB design, validation, and manufacturing exports through natural language.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to drive KiCAD PCB design automation through MCP, covering schematic authoring, board and routing operations, footprint/symbol libraries, vendor PCB import, validation and DRC, and manufacturing export. It exposes 236 registered tools with keyword discovery, dynamic project-state resources, and optional Streamable HTTP transport with fail-closed Bearer authentication.MIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP-capable AI agents to generate and reorganize schematics, resolve LCSC components, place and route PCBs with custom DRC constraints, inspect design data, and safely apply, repair, or restore changes in native EasyEDA Pro and JLCEDA documents.219MIT