Skip to main content
Glama

Proteus MCP

CI License: MIT

面向 AI Agent 的 Proteus 通用操作接口,目标是逐步开放 Proteus 的各项能力,让 Agent 能够直接使用 Proteus 完成电子设计工作。

项目处于实验阶段。兼容范围 · 本机初始化 · 已知限制

安装 · 客户端配置 · 使用示例 · 工具参考 · 问题反馈

当前支持

功能

支持内容

器件库

搜索本机 .LIB,查看物理引脚、隐藏电源和器件属性

原理图

器件放置、旋转与镜像、自动布局、正交连线、汇接点及 .pdsprj 导出

当前工程

在 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 setup

Proteus、器件库和 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 tools
catalog_listB
Read-only

List supported logical devices and pins; library_path explicitly selects ambiguous installed devices. NOT placement verification.

Inputs: device, library_path.

circuit_editA
Destructive

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_addB
Destructive

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_setC
Destructive

Update logical properties or placement; native status becomes not_applied.

Inputs: ref (required), project (required), properties (required), expected_revision (required), +3 more.

connect_pinsC
Destructive

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_interruptA
Destructive

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_chaserC
Destructive

Create a NEW 12MHz 12T 8051, P1 active-low 8-LED circuit and C51 main.c.

Inputs: project (required).

export_netlistB
Destructive

Export portable semantic netlist.json, NOT an importable Proteus native file.

Inputs: project (required).

export_svgC
Destructive

Export named-net connectivity preview.svg. This is NOT a Proteus screenshot or .pdsprj.

Inputs: project (required).

firmware_buildB
Destructive

Actually run installed C51, BL51 and OH51; preserve logs and verify Intel HEX. NOT simulation.

Inputs: project (required).

firmware_inspectB
Read-only

Read Intel HEX and validate checksums, addresses, overlap and reset vector.

Inputs: path (required).

library_deviceB
Read-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.

live_editA
Destructive

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_historyA
Destructive

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_readA
Read-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_bomA
Destructive

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_applyB
Destructive

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_checkA
Destructive

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_commandsB
Read-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_createA
Destructive

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_exportC
Destructive

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_chaserB
Destructive

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_inspectB
Read-only

Read .pdsprj ZIP contents and hashes. Does NOT claim electrical verification.

Inputs: path (required).

native_previewC
Destructive

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_readB
Read-only

Read calibrated native components, properties and stored pin references directly from .pdsprj. No UI. Not simulation verification.

Inputs: path (required).

native_set_componentB
Destructive

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_statusB
Read-only

Read commands, logs, modal dialog and simulation state via version-pinned Qt function bridge. Optional Frida; no input emulation.

Inputs: session (required).

native_verifyC
Destructive

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_readA
Read-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_routeA
Destructive

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_layersA
Destructive

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_pushA
Destructive

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_chainA
Destructive

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_closeA
Destructive

Request normal WM_CLOSE for a tracked Proteus session. Does not force termination or dismiss unsaved-change dialogs.

Inputs: session (required).

project_createB
Destructive

Create a NEW semantic circuit directory; never overwrite existing directories.

Inputs: project (required).

project_openA
Destructive

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_planB
Destructive

Export deterministic plan.json. Status is planned, not applied to Proteus.

Inputs: project (required).

project_readC
Read-only

Read circuit revision and source hash.

Inputs: project (required).

project_reopenA
Destructive

Save, verify circuit preservation, close normally, then reopen the same tracked project. Stops if saving or normal close is unconfirmed.

Inputs: session (required).

project_saveA
Destructive

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_validateA
Read-only

Check model pin existence, MCU supplies/reset and floating passive pins. NOT full ERC.

Inputs: project (required).

proteus_doctorA
Read-only

Report capability-specific health. Installed is not verified working.

Inputs: no named parameters.

runtime_diagnosticsB
Destructive

Collect Windows crash events, dump paths and process state for a tracked launch, saving diagnostics.json.

Inputs: session (required).

runtime_statusB
Read-only

Read running Proteus process, window and menu metadata. No screenshots or input emulation.

Inputs: session.

simulation_controlB
Destructive

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_displayA
Destructive

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_inputsA
Read-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_logB
Read-only

Read actual Proteus simulation log rows directly from the native item model. No menu, screenshots or input emulation.

Inputs: session (required).

simulation_observeA
Destructive

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_sampleB
Destructive

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_stimulateA
Destructive

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_writeA
Destructive

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

    B3/5.0

    Scored across 53 tools

    Disambiguation2/5

    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).

    Naming Consistency3/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Local 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      219
      MIT