maxplus2-mcp
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., "@maxplus2-mcp compile my MAX+plus II project and show any timing errors"
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.
maxplus2-mcp — MAX+plus II MCP 服务器
让支持 MCP 的 AI agent 使用 MAX+plus II:读取和修改工程、GDF 原理图、SYM 符号和 SCF 波形,运行原厂编译与仿真,并操作 Windows 原生界面。
适用于 Altera MAX+PLUS II / MaxPlus II / MaxPlus2 的数字电路实验与 FPGA/CPLD 工程,包含 AHDL、VHDL、Verilog 源码和专有原理图、波形文件处理。
当前版本 0.10.3,提供 68 个工具,采用本地 stdio MCP。 运行时只使用 Node.js 内置模块,不需要安装 npm 依赖。 Windows 界面后端属于本项目,通过 Win32 和 UI Automation 工作;任何能连接 本地 stdio MCP 的客户端都可调用,无需 Codex Computer Use 或其他 agent SDK。
项目把工程文件解析、原厂命令行与 Windows 界面操作组合在一个服务中。 AI 可以先读取实际电路和波形,以文件方式进行受检修改,再通过原厂工具验证 结果;遇到向导或未解码的编辑器属性时,使用项目自带的界面后端继续操作。
下载: 最新 Release 提供精简发行包、完整源码包、标准 MCPB 安装包、目录元数据和 SHA-256 校验文件。
查找与连接: 官方 MCP 目录 ·
GitHub 搜索 ·
其他 agent 的查找与连接说明。
目录中的名称为 io.github.Hachimeder/maxplus2-mcp;连接方式为本地 stdio。
数字电路(数电)实验中的 AI 辅助
如果你在寻找「MAX+plus II AI 辅助工具」「MaxPlus2 MCP」「GDF 原理图解析与 编辑」或「SCF 波形自动生成与仿真」,本项目提供相应的本地工具。AI 可以创建 和修改原理图、准备波形激励、编辑 AHDL/VHDL/Verilog 源码,再调用原厂编译器 和仿真器读取实际报告与结果。它也适用于 Altera FPGA/CPLD 工程的文件处理。
常见问题是「AI 能不能直接画 GDF、填写 SCF、操作 MAX+PLUS II?」:连接本地 MCP 后,可以使用对应文件工具及项目自带的 Windows 自动化后端;具体支持范围 见下面的能力表及 格式说明,验证证据见 测试说明。
在 GitHub 中可直接搜索 MaxPlus2 MCP、MaxPlus II MCP、数字电路 MCP
或 数电 MCP。按场景查找也可使用 topic:altera topic:mcp、
topic:cpld topic:mcp、topic:waveform-simulation topic:mcp。
Related MCP server: Computer-Controller-Bridg
能力
范围 | 功能 |
工程和源码 | 新建、复制、查找、读取、编辑、备份和恢复;ACF 配置、HDL、MIF、VEC |
GDF 原理图 | 原始几何、符号位置、旋转/镜像、引脚坐标、导线、注释、参数和声明 |
GDF 连接 | 原实例/引脚网络、显式总线逐位连接、受检标量移动补线、匿名叶端清理 |
SYM 符号 | 新建、编辑、检查、选择性刷新嵌入定义,保留未选实例 |
文字和颜色 | 字体、显式 Windows-936 中文、保存的颜色角色;检查并清理覆盖引脚标签的重复 DOC |
SCF 波形 | 输入事件、X/Z、信号增删、名称、组、进制、顺序和时长;clock/counter/repeat 等刺激 |
编译与分析 | 原厂编译、仿真、时序分析、导出综合网表;异步任务、取消、报告与结果验证 |
Windows 界面 | 窗口、截图、UIA、菜单、键盘、鼠标、拖动和滚动;观察有效期和输入去重 |
工具的参数由 MCP tools/list 提供,也可查阅 完整工具列表。
优先使用文件工具处理已解码格式,界面工具处理向导、菜单和其他编辑器操作。
安装与连接
文件工具需要 Node.js 18+。原厂编译、仿真和界面操作需要 Windows 以及 你自行安装并取得适用许可的 MAX+plus II。原厂工具链曾在 10.2 上验证。 界面操作还需要 .NET Framework 4.8 和已登录、未锁定的交互式桌面。 本仓库不包含 MAX+plus II 安装包、程序、设备库或许可证。
使用 Release 发行包
支持 MCPB 的 Windows 客户端可导入 maxplus2-mcp-v0.10.3.mcpb,在客户端中
选择软件安装目录和工程目录。其他 stdio MCP 客户端使用下面的 ZIP 配置步骤。
从 v0.10.3 Release 下载
maxplus2-mcp-v0.10.3.zip并解压到固定目录。确认本机已安装 Node.js;执行
node --version检查。按下面的配置示例连接 MCP 客户端,填写实际软件安装目录和工程目录。
发行包包含运行源码、Windows 后端源码、两种语言的介绍及操作文档。
运行时不需要 Git,不需要执行 npm install;Windows 后端首次使用时自动编译。
maxplus2-mcp-v0.10.3-source.zip 另包含开发脚本、公开测试和 CI 模板,适合开发与贡献。
从源码安装
git clone https://github.com/Hachimeder/maxplus2-mcp.git
cd maxplus2-mcp
node --version复制 mcp-config.example.json 中的服务定义到客户端的 MCP 配置,填写实际路径。示例中的目录是占位路径:
{
"mcpServers": {
"maxplus2": {
"command": "node",
"args": ["C:\\tools\\maxplus2-mcp\\server.mjs"],
"env": {
"MAXPLUS2_ROOT": "C:\\maxplus2",
"MAXPLUS2_WORKSPACE": "C:\\fpga-projects"
}
}
}
}若客户端不能从 PATH 找到 Node,将 command 改为本机 Node 可执行文件的绝对路径。
客户端的配置格式可能不同,核心是用上述 command、args、env 启动 stdio 进程。
可用以下命令检查路径和原厂编译器,并生成被 Git 忽略的本机配置:
node scripts/configure-local.mjs --root "C:\maxplus2" --workspace "C:\fpga-projects"
node scripts/configure-local.mjs --root "C:\maxplus2" --workspace "C:\fpga-projects" --apply也可通过 start-local.ps1 启动,或使用以下命令检查安装。正常 stdio 启动后由
MCP 客户端发送 JSON-RPC 请求;诊断日志使用 stderr。
node scripts/local-startup.mjs --check --root "C:\maxplus2" --workspace "C:\fpga-projects"原生后端会从 native/MaxplusDesktop.cs 自动编译到被忽略的 bin/。
手动构建可运行 pwsh -NoProfile -File scripts/build-desktop.ps1 -SelfTest。
推荐操作顺序
installation_status检查环境,project_clone建立工作副本。project_parse_file或专用 inspect 工具读取实际内容和 SHA-256。用编辑工具预览修改,检查变化、连接和限制;已授权修改使用
confirm:true及刚读取的expectedSha256提交。该参数是工具的事务控制。编译和仿真,检查本次生成的报告、连接和真实输出。异步任务使用
job_status/job_cancel。需要界面时使用
desktop_windows→desktop_observe→desktop_action。 使用最新的 observationId,读取动作后返回的新观察再决定下一步。
验证与开发
以下开发命令在 Git 克隆目录或完整源码包中运行:
npm run audit:public
npm test默认测试使用独立样例和模拟后端,不需要 MAX+plus II 安装、私人实验工程或 原厂库文件。需要实机软件验证时设置安装目录:
$env:MAXPLUS2_ROOT = "C:\maxplus2"
npm run test:native原厂测试在临时目录建立自制电路,运行编译、仿真和网表检查。原生桌面测试还 需要交互式 Windows 会话。公开检查不依赖原厂安装。 仓库附有 GitHub Actions 模板;启用方式见 CI 说明。
公开测试中的分页 GDF 在运行时由自制符号生成;SCF 样例来自自制 XOR 工程, 不包含私人课程实验或本机路径。贡献时请运行检查,并使用可公开的最小复现。 测试范围及实测结果见 验证说明。
已知边界
文件编辑主要支持已确认的 GDF v6 / SCF v4,未知记录保留或拒绝修改。 参数化宏的总线宽度、完整层级内部连接、总线自动布线,以及部分 SCF 编辑器 私有显示字段仍有限制。源连接模型和综合后的网表回答不同问题,修改逻辑后 仍需原厂编译仿真确认。通用界面入口提供软件操作途径,不能证明每个菜单功能 都已经逐项验证;客户端还需把截图传给具备视觉能力的模型处理复杂画布。 实际烧录需要支持的硬件,仓库测试不验证硬件烧录。
许可和隐私
本项目代码采用 MIT License。第三方软件及样例来源见 NOTICE.md。本机配置、日志、截图、备份、实验工程及原厂软件不属于 发布内容。MCP 返回的数据可能经客户端发送给模型服务,详见 SECURITY.md。
Available Tools
68 toolsacf_read_pinsRead pin assignmentsARead-onlyIdempotent
Extract device and pin assignments from the .acf CHIP block, and cross-check them against the compiler-generated .pin report when present. Read-only.
Inputs: project (required), workspace.
acf_read_sectionsRead ACF sectionsARead-onlyIdempotent
Read the .acf as structured sections/entries with line numbers. Use to discover which section holds a setting before writing. Read-only.
Inputs: project (required), section, workspace, includeEntries.
acf_repair_chip_headersRepair CHIP headersADestructive
Rewrite malformed CHIP headers (bare "CHIP " or shell-escaped names) into canonical "CHIP " form. setacf is append-only and cannot fix these itself. Preview-first; requires confirm:true to write and backs the file up.
Inputs: project (required), backup, confirm, chipName, +1 more.
acf_validateValidate ACFARead-onlyIdempotent
Statically validate an .acf for defects that block compilation, notably the bare "CHIP " header that setacf itself creates when no CHIP section exists yet (MAX+PLUS II then fails with "Missing identifier after section keyword"). Read-only.
Inputs: project (required), workspace.
capability_matrixDiscover available MAX+plus II capabilitiesBRead-onlyIdempotent
Return precise routes and runtime requirements for authoring, compilation, simulation and native GUI-only workflows. Distinguishes implemented entry points from operations verified on this machine and physical programming requirements.
Inputs: no named parameters.
desktop_actionPerform one observed MAX+plus II actionADestructive
Directly execute ONE click, hover, key chord, Unicode text entry, value change, drag, scroll, secondary UI action or activation, then return a fresh screenshot/tree. Uses MCP-owned Win32/UIA. Requires latest observationId/windowId. Inspect after every input; no host-specific calls.
Inputs: action (required), windowId (required), observationId (required), root, +2 more.
desktop_launchLaunch a MAX+plus II GUI programA
Launch an existing allowlisted MAX+plus II GUI through the independent Windows backend and return its real windows. No shell or arbitrary executable. Launch does not prove readiness; observe the returned window.
Inputs: root, program.
desktop_observeObserve a MAX+plus II windowARead-onlyIdempotent
Return a fresh native screenshot as standard MCP image content, UI Automation tree, focus, window bounds and observationId directly. Inspect before acting; each input consumes its observation. Capture diagnostics report limitations honestly.
Inputs: windowId (required), root, menuLimit, textLimit, +4 more.
desktop_resultRead a recent desktop operation resultARead-onlyIdempotent
Retrieve a cached completed desktop result and its MCP image blocks without executing input again. Results last up to ten minutes, twelve entries, or server restart. No separate host execution step exists.
Inputs: requestId (required), root.
desktop_statusCheck independent Windows desktop backendARead-onlyIdempotent
Check the MCP-owned Windows UI Automation/Win32 backend. Builds the bundled helper locally if needed and reports interactive desktop availability. Runs locally using standard Windows components. Does not launch or manipulate a MAX+plus II window.
Inputs: root.
desktop_windowsList MAX+plus II windowsARead-onlyIdempotent
Directly discover real windows/dialogs of installed MAX+plus II executables, including HWND, PID, bounds and title. Select exactly one returned windowId before observing/input. All agents call this standard MCP tool.
Inputs: root.
display_palette_inspectInspect stored original application colorsARead-onlyIdempotent
Read only the [Colors] section of installed maxplus2.ini. Separate ordinary DOC Text, native Symbol Pinstub Names, and Nodes & Connection Dots roles. Reports stored preferences, not live unsaved colors; GDF color bits and custom previews cannot prove native display. Verify visible colors using original Color Palette Preview and desktop_observe.
Inputs: root.
gdf_connectionsInspect original source connectionsBRead-onlyIdempotent
Build source nets preserving unsynthesized instances/pins. Original endpoint/overlap, pin-on-wire, transparent WIRE and remote-name rules; crossings, driver and dangling diagnostics. Separate bitTopology expands explicit bus ranges, scalar member aliases and WIRE ordered/reversed mappings; unresolved widths remain explicit. Paginated; original compilation proves electrical legality.
Inputs: path (required), limit, offset, project, +3 more.
gdf_constructConstruct schematics and edit parameters and wire namesADestructive
Transactional GDF v6 construction: insert hashed SYM instances, name I/O and electrical wires/buses, replace/clear modern parameter assignment maps, normalize invalid/duplicate native NET_IDs, add/delete orthogonal wires, symbols and free annotations. Existing offsets/current SHA-256 required; preview/backup/atomic apply. Deleted symbols leave wires. Same wire names can connect remote geometry; actual parameters and connections require original compiler/simulator verification. Legacy/ambiguous parameter records are preserved and refused for edits.
Inputs: path (required), operations (required), expectedSha256 (required), root, +3 more.
gdf_createCreate a blank original-format schematicA
Create a version-6 GDF sheet with the recovered original-editor blank header/extent. Preview by default; never overwrite an existing file. Use gdf_construct for symbols/wires, then original compiler/simulator for circuit verification.
Inputs: path (required), width, height, confirm, +2 more.
gdf_declarationsInspect original CONSTANT/PARAM declarationsARead-onlyIdempotent
Read existing native CONSTANT h/51/52 and PARAM h/53/54 declaration pairs. Reports writable and ambiguous/unsupported legacy forms. These are source declarations or defaults, not generic instance parameter assignments.
Inputs: path (required), limit, offset, project, +3 more.
gdf_declarations_editEdit original constant and parameter declarationsADestructive
Edit only an existing unambiguous native CONSTANT/PARAM name/value pair. Retains native IDs, aliases, geometry, fonts and other properties. Requires both name and value, fresh hash, preview and recoverable backup. Compiler/simulator must validate expression, scope and effect.
Inputs: path (required), edits (required), expectedSha256 (required), confirm, +2 more.
gdf_editEdit existing schematic geometryADestructive
Preview/apply lossless GDF v6 root line coordinates, translations, symbol orientation or free annotation text. Existing records only. Requires fresh file SHA-256, rejects unsupported targets/overflow, preserves unrelated bytes and backs up before atomic replacement. Moving a symbol does not move its wires; recompile/export to verify circuit behavior.
Inputs: path (required), edits (required), expectedSha256 (required), confirm, +2 more.
gdf_geometryRead original schematic geometryARead-onlyIdempotent
Strictly decode GDF/SYM v2..6 coordinates, wires/buses, symbol definitions, original instances, rotations/mirrors, stretched world pin positions and local text anchors. No compiler or GUI needed. Paginated root records and nested collections preserve offsets/counts. Geometry does not prove connectivity; use netlist_export for circuit connections.
Inputs: path (required), view, limit, offset, +4 more.
gdf_graphics_editCreate/edit all root schematic graphicsADestructive
Add/delete or resize/restyle root drawing lines, circles and arcs. Original unknown flags/shared symbol definitions retained; drawing lines are not electrical wires. Use gdf_construct for connections. Original offsets/current hash, preview and backup required.
Inputs: path (required), operations (required), expectedSha256 (required), confirm, +2 more.
gdf_inspectInspect a schematicARead-onlyIdempotent
Read a strictly validated GDF/SYM schematic summary: labels, fonts, title fields and geometry counts. gdf_geometry provides paginated original coordinates, definitions, instances and world pin positions; gdf_edit supports existing v6 geometry. Electrical connectivity requires netlist_export. Optionally compare labels with another drawing.
Inputs: path (required), workspace, compareWith.
gdf_move_connectedMove or rotate symbols with checked reconnectionADestructive
Move selected GDF6 placements on grid8 and/or choose orientation0..7. Route scalar pin extensions around other source nets and symbol interiors; split existing wires at departed interior pins. Refuse any changed source terminal partition or named-net membership. Original compilation/export/simulation required. Bus bundles/unknown topology refused. Hash/preview/backup transaction.
Inputs: path (required), edits (required), expectedSha256 (required), confirm, +3 more.
gdf_pin_labelsInspect or clean overlapping pin labelsADestructive
File-only GDF/SYM diagnostics. Omit expectedSha256 to inspect exact pin/DOC duplicates and fixed-font same-row pin collisions. Supply a fresh hash to preview cleanup; confirm=true applies with backup. Removes only exact visible duplicate free DOC, preserving native pin labels. Optional right-label alignment moves label anchors only. Does not infer arbitrary glyph/layout collisions.
Inputs: path (required), limit, offset, confirm, +6 more.
gdf_symbol_libraryRead original symbol prototypesARead-onlyIdempotent
List installed max2lib SYM files with SHA-256 and names, or inspect one prototype with local pins, extent and preserved default instance/parameter attributes. Read-only. Symbol insertion uses these hashes and original bytes, independently of any agent SDK.
Inputs: path, root, limit, query, +1 more.
gdf_symbol_refreshUpdate embedded schematic symbols from SYMADestructive
Preview or apply a hashed same-name/same-type SYM to explicitly selected GDF instances. Shared definitions split so unselected instances retain original bytes. Instances/NET_ID/parameters/placement/rotation remain. Reports pin/interface and geometric contact changes; these require explicit allow flags. Compile/export/simulate to prove actual connectivity.
Inputs: path (required), template (required), selectors (required), expectedSha256 (required), +11 more.
gdf_text_editEdit all root annotation text fieldsADestructive
Create, reposition, restyle or delete root free DOC annotations. Preserves font, metrics, alternative text and opaque bits; refuses electrical labels or instance/pin text. Sequential operations use original offsets and return resulting offsets. Printable Latin-1 only.
Inputs: path (required), operations (required), expectedSha256 (required), confirm, +2 more.
gdf_text_format_editEdit root DOC fonts, metrics and encoded textADestructive
Create/change only free root DOC text in GDF6 or standalone SYM2..6. Choose built-in font0..3 or Windows font face,size with explicit width/height. Exact reversible Windows-936 encoding supports Chinese bytes; Chinese requires Windows font. Preserves electrical labels, shared definitions and opaque tails. Verify glyphs with original editor.
Inputs: path (required), operations (required), expectedSha256 (required), confirm, +2 more.
gdf_text_format_inspectInspect native fonts and explicitly decoded textARead-onlyIdempotent
Inspect all GDF/SYM q records, original font strings, built-in font codes, stored metrics and raw text bytes. Explicit latin1/windows-936 decoding; no guessed encoding. Pagination and malformed-encoding diagnostics.
Inputs: path (required), limit, offset, project, +4 more.
gdf_wire_cleanupPrune checked anonymous wire tailsADestructive
Remove only unannotated electrical leaf segments in GDF6 pin-bearing physical nets. Preserve surviving token bytes, named wires, pins, isolated unconnected nets and overlapping conductors. Every round checks source scalar pin partitions and complete bus bit/alias partitions. Refuse unknown topology or exceeded budgets; compile and simulate the result independently. Fresh hash, preview and backup transaction.
Inputs: path (required), expectedSha256 (required), confirm, project, +3 more.
installation_statusInstallation statusARead-onlyIdempotent
Locate the MAX+PLUS II installation (maxplus2.exe / setacf.exe), report version info from maxplus2.ini, available device families, and additional bundled tools. Read-only.
Inputs: root.
job_cancelCancel a background jobADestructiveIdempotent
Terminate a running background job by killing its child process. Use this rather than abandoning a job: an abandoned job keeps running and keeps holding the project directory. Build artifacts already written are left in place — this stops work, it does not undo it.
Inputs: jobId (required).
job_statusCheck a background jobARead-onlyIdempotent
Poll a background job started with async:true. Returns running/done/failed/cancelled, how long it has been going, how many child processes are live, and the full result once it settles. This exists because a client timeout is wall-clock and does NOT stop the work: polling is the only way to keep a long compile without losing it. Results are held for 30 minutes after they settle.
Inputs: jobId (required).
list_projectsList projectsBRead-onlyIdempotent
Recursively find .acf projects under a root directory and list the artifacts already compiled for each. Read-only.
Inputs: root, limit, maxDepth.
maxplus2_planPlan a maxplus2 runARead-onlyIdempotent
Build the exact maxplus2.exe command line for compile / timing analysis / simulation / object conversion, WITHOUT running it.
Inputs: project (required), cwd, root, taReg, +24 more.
maxplus2_runRun maxplus2A
Execute maxplus2.exe (compile / simulate / timing / convert) with a hard timeout, then report which artifacts changed and the parsed report summary. Beware: this starts a 2002-era Win32 process that can block on modal dialogs.
Inputs: project (required), cwd, root, async, +26 more.
memory_writeWrite a ROM/RAM memory imageA
Generate an Intel/Altera MIF with explicit WIDTH, DEPTH, hexadecimal addresses/data and initialized unused addresses. Arbitrary width values may use integer strings. Preview or apply to a .mif with hash checking/backups.
Inputs: path (required), depth (required), width (required), values (required), +5 more.
netlist_exportExport circuit connectivity with the original compilerA
Copy a GDF/HDL/ACF/EDIF design and local dependencies to a fresh temporary directory; enable original MAX+plus II EDIF/VHDL/Verilog/AHDL writers and compile there. Return source hashes, actual compiler evidence, exported files and structured port/instance/net connectivity. Original files remain untouched. The netlist is synthesized logic; original drawing placement and source component identities can change. Supports async jobs and cancellation.
Inputs: path (required), root, async, project, +2 more.
parse_reportParse a reportBRead-onlyIdempotent
Parse a MAX+PLUS II .rpt / .summary / .pin file into structured severity counts, statuses, device, and diagnostics. Read-only.
Inputs: path, project, workspace, maxDiagnostics.
parse_tblParse result tableARead-onlyIdempotent
Parse an existing MAX+PLUS II Simulator result table (.tbl) into a time-indexed trace of inputs, outputs and buried nodes, with optional expected-value checking. Read-only.
Inputs: full, path, limit, expect, +3 more.
probe_executableProbe the executableAIdempotent
Run maxplus2 -v (or -h) to verify the 2002-era binary actually starts and returns on this host. Read-only and project-independent. Run this before trusting any headless compile loop: MAX+PLUS II can block forever on a modal dialog.
Inputs: cwd, mode, root, timeoutMs.
project_cloneClone a project for isolated workA
Copy the project directory into a new directory; preserve names and verify SHA-256 for every copied file. Default all; sources selects design extensions and explicit includePaths, avoiding old SCF/TBL/reports in large projects. Preserves originals, excludes backup stores. Does not infer external hierarchy dependencies; inspect and compile the copy.
Inputs: project (required), directory (required), confirm, profile, +2 more.
project_createCreate a MAX+plus II projectA
Create an isolated directory with a named CHIP .acf, optional HDL source and END_TIME=0.0ns. Preview by default, refuse existing directories; use one directory per design.
Inputs: name (required), device, source, confirm, +4 more.
project_edit_fileEdit or manage a project fileADestructive
Write, exact-patch, copy, move or delete one file. Preview by default. Existing files require expectedSha256; writes/moves/deletes preserve a recoverable backup. General binary writes are refused; use scf_edit for supported SCF scalar inputs and desktop tools for GDF drawing changes.
Inputs: path (required), edits, confirm, content, +6 more.
project_filesList project filesARead-onlyIdempotent
List sources, memories, schematics, waveforms and build artifacts under the selected project/workspace. Deterministic offset pagination, byte sizes and supported text formats are returned.
Inputs: limit, offset, project, workspace.
project_inspectInspect projectARead-onlyIdempotent
Summarize one project: .acf sections, CHIP blocks, device, pin count, compiled artifacts with timestamps, and the cleanliness of the last .rpt. Read-only.
Inputs: project (required), workspace.
project_parse_fileParse design and waveform files directlyARead-onlyIdempotent
File-first structured parsing of strict GDF text/geometry, SCF scalar/bus logic events in ns, ACF assignments, TBL traces, reports and EDIF connections. Returns original path/bytes/SHA-256 and explicit limitations. Use gdf_geometry for paginated symbol definitions/placements and netlist_export for GDF circuit connections.
Inputs: path (required), net, cell, limit, +11 more.
project_read_fileRead a project text fileBRead-onlyIdempotent
Read a bounded line range and exact SHA-256 of HDL, ACF, MIF, HEX, VEC, reports or other supported text. Use nextLine to continue and expectedSha256 to avoid overwriting concurrent edits.
Inputs: path (required), project, encoding, lineCount, +2 more.
project_restore_fileRestore backed-up project bytesADestructive
Restore a file from this project backup store, including binary GDF/SCF bytes. Preview by default. Requires backup SHA-256; an existing destination also requires its current SHA-256 and is backed up before restoration.
Inputs: path (required), backup (required), backupSha256 (required), confirm, +3 more.
project_searchSearch design sources and reportsARead-onlyIdempotent
Search for a literal string across supported project text files with file/line evidence. Results are bounded and truncation/oversized skipped files are explicit; binary GDF/SCF content is not guessed.
Inputs: query (required), limit, project, encoding, +2 more.
scf_compiled_portsInspect compiled waveform port namesARead-onlyIdempotent
Read an exported .edo file up to32MiB and map top-level input/output ports to MAX+plus II Simulator names, including explicit vector ranges and native flattening. Internal EDIF nets, ambiguous arrays and INOUT are marked unsupported. Use netlist_export then inspect this fresh file.
Inputs: path (required), limit, offset, project, +3 more.
scf_createCreate original-format waveform stimulusA
Create a new version4 SCF directly without VEC or GUI. Explicit input names and optional 0/1/X/Z events; events in ns on 0.1ns grid. Never overwrite. Use matching compiled netlist and original simulator for verification.
Inputs: path (required), inputs (required), durationNs (required), confirm, +2 more.
scf_editEdit binary SCF input stimulus directlyADestructive
Preview/apply event changes to existing scalar inputs in vendor version-4 SCF. Fixed existing end time, exact 0.1ns ticks, 0/1/X/Z. Preserve groups, other signal records and opaque editor bytes. Requires current SHA-256; backs up before atomic write. Output/internal traces become stale and must be re-simulated. For a bus, edit its scalar members returned by scf_inspect.
Inputs: path (required), edits (required), expectedSha256 (required), confirm, +2 more.
scf_editor_metadataInspect waveform editor metadata and supported operationsBRead-onlyIdempotent
Expose known display/time fields and bounded raw metadata, clearly identifying unresolved cursor/grid/zoom/private references. Preserves opaque bytes; do not infer their meaning from a round trip.
Inputs: path (required), limit, offset, project, +3 more.
scf_from_compiled_createCreate waveform with compiled input and output portsA
Create a new SCF from selected or all supported top-level ports in a hashed .edo. Direct original SCF records, no VEC. Inputs0 and output observationsX; use scf_stimulus_edit then the original Simulator. Never overwrites; unresolved nodes require explicit supported selection.
Inputs: path (required), edifPath (required), durationNs (required), edifSha256 (required), +4 more.
scf_inspectRead binary waveform events directlyARead-onlyIdempotent
Decode verified SCF scalar and display-bus logic runs/events, including 0/1/X/Z, with times in ns. Returns input/output roles, writable input names, paging and unsupported metadata explicitly. Does not open the GUI.
Inputs: path (required), limit, offset, signal, +6 more.
scf_ports_importImport missing compiled waveform portsADestructive
Append selected top-level input/output nodes from a fresh hashed .edo to an existing hashed SCF. Retains existing waveforms; inputs begin0, outputsX until simulated. Refuses role mismatches/unsafe opaque references. Both files must be inside the same scope.
Inputs: path (required), edifPath (required), edifSha256 (required), expectedSha256 (required), +4 more.
scf_stimulus_editGenerate and transform native SCF input waveformsBDestructive
Native SCF clock, repeated 0/1/X/Z segments, wide MSB-first counters, shift, invert, fill and snapshot copy. Exact 0.1ns grid, bounded200000 total events; preserves waveforms outside edited half-open ranges and all opaque records. Fresh original simulation computes outputs.
Inputs: path (required), operations (required), expectedSha256 (required), confirm, +2 more.
scf_structureInspect waveform structureARead-onlyIdempotent
Decode version4 SCF scalar names, display ordering, groups/radix, duration and native record locations. Exposes unknown/reference limits. Use scf_inspect for paginated logic events.
Inputs: path (required), limit, offset, project, +3 more.
scf_structure_editEdit waveform names, grouping and time spanADestructive
Transactional SCF signal rename/reorder, group/ungroup/radix, duration extension/truncation and input add/delete. Unknown fields preserved; unsafe opaque reference changes refused. Names must match compiled nodes; resimulate after edits.
Inputs: path (required), operations (required), expectedSha256 (required), confirm, +2 more.
setacf_applyApply a setacf changeA
Execute a setacf change. Backs the .acf up first and returns a line diff. Requires confirm:true. Prefer calling setacf_plan first.
Inputs: confirm (required), project (required), pin, kind, +15 more.
setacf_planPlan a setacf changeARead-onlyIdempotent
Build the exact setacf.exe argument vector for a change WITHOUT executing it. Always call this first: setacf edits the .acf in place and has no dry-run mode.
Inputs: project (required), pin, kind, root, +11 more.
simulate_and_verifySimulate and verifyAIdempotent
Run the Simulator headless and return the parsed result table, then optionally check expected output values. This is how simulation verification is automated: MAX+PLUS II writes a plain-text .tbl containing the simulated outputs, so a design can be checked without a human reading a waveform. Note a successful simulation may exit 1 — the verdict comes from the success banner plus the table artifact.
Inputs: project (required), scf, tbl, root, +6 more.
stimulus_writeWrite timed simulator stimulusB
Generate a verified multi-row VEC shape using INTERVAL, bare pattern rows and one final semicolon. Explicit bus nodes are MSB-first. Preview/apply with backups. Existing SCF may take precedence; inspect/delete its backed-up copy or open/convert VEC in the GUI. Set ACF END_TIME=0.0ns.
Inputs: path (required), rows (required), inputs (required), stop, +8 more.
sym_createCreate or clone a custom symbolA
Create a new original-format SYM or clone a hashed workspace/installed-library prototype under a new name. Never overwrite. Optional operations add internal graphics/text/pins. Matching HDL source interface must be supplied separately and compiler/export used to prove connectivity.
Inputs: name (required), path (required), pins, root, +9 more.
sym_editEdit a standalone symbolADestructive
Rename/resize standalone SYM, edit/create/delete internal lines/circles/arcs/text and interface pins. Uses original attributes and preserves unrelated/default records. Changes do not update embedded GDF symbol copies. Inspect fresh offsets/hash; verify consuming circuit with original compiler.
Inputs: path (required), operations (required), expectedSha256 (required), confirm, +2 more.
sym_inspectInspect a custom symbol interfaceARead-onlyIdempotent
Inspect standalone SYM graphics, pin names/positions/native interface directions, text display flags and preserved instance defaults. No compiler needed. Paginated collections; direction provenance does not prove circuit wiring.
Inputs: path (required), limit, offset, project, +3 more.
waveform_resultsExtract valid output events and viewing intervalARead-onlyIdempotent
Extract result events gated by an actual scalar valid signal. Default proven rising edges, with initial-high rows separately marked; optional samples means native rows while valid=1. Optional settling samples point-in-time data inside the valid window. Retains raw numeric/X/Z tokens, missing columns and unknowns; held data while valid is low creates no result. Return paginated events and a recommended ns window; does not alter SCF zoom, row visibility, clock or design logic.
Inputs: path (required), dataSignals (required), validSignal (required), edge, +12 more.
waveform_signalsInspect actual simulation table columnsARead-onlyIdempotent
Read an original TBL and return real declared input/output/buried signals, bit widths, native units and available time span. Detect malformed tables, ambiguous names and exceeded budgets. Hidden SCF signals absent from TBL remain absent; this does not prove saved editor layout.
Inputs: path (required), limit, offset, maxRows, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 68 tools
Descriptions are unusually explicit about boundaries and cross-reference sibling tools ('use gdf_geometry for...', 'use netlist_export for...'), which helps. However the surface has large overlapping clusters — e.g. gdf_text_edit vs gdf_text_format_edit (both edit free root DOC text), gdf_graphics_edit vs gdf_edit vs gdf_construct, and scf_edit vs scf_stimulus_edit vs scf_structure_edit — where an agent can easily pick the wrong one.
Everything is snake_case and grouped by predictable subsystem prefixes (gdf_, scf_, project_, desktop_, acf_, setacf_, maxplus2_, job_). But verb ordering is inconsistent: noun_verb forms (acf_read_pins, project_read_file, gdf_text_edit) coexist with verb_noun forms (list_projects, parse_tbl, simulate_and_verify, probe_executable), and many tools carry no prefix at all.
68 tools is an extreme mismatch for a single server. Even a rich legacy-EDA workflow does not justify this many entry points, and the count forces agents to navigate many near-duplicate edit/inspect variants rather than a focused set.
The surface covers the full lifecycle: project create/clone/files/read/write/search/parse, ACF read/validate/repair, setacf plan/apply, compile/simulate plan/run, result parsing, GDF/SYM/SCF authoring and editing, netlist export, waveform analysis, job control, and desktop GUI automation. Almost no obvious functional gap remains for the stated domain.
Maintenance
Related MCP Connectors
Stdio MCP proxy: free probe, then x402-paid ReadFetch tools; for hosts that cannot sign x402.
MCP server to assist with JxBrowser development.
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables querying PCB and schematic data and driving DelphiScript automation in Altium Designer via MCP.1310MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI clients on Windows to control the local mouse, keyboard, and screen understanding via MCP stdio, allowing automated workflows like viewing the screen, locating elements, clicking, typing, and verifying results.1Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables local stdio-based MCP integration with InoProShop/CODESYS for project structure reading, POU editing with verified writes, compilation, task configuration, and persistent session recovery.4MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI to read, reliably edit, compile, and observe a local E5.95 EasyLanguage IDE over MCP, including project snapshots, declarations, native listview preparation, support-library metadata, and fault/variable capture. It works without simulating keyboard or mouse input and without depending on AutoLinker.4MIT