MAX+plus II MCP / 数字电路 AI 工具 MCP server

maxplus2-mcp — MAX+plus II MCP 服务器

简体中文 | English

让支持 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。

能力

工具的参数由 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 配置步骤。

下载 maxplus2-mcp-v0.10.3.zip 并解压到固定目录。

1. 从 v0.10.3 Release

1. 确认本机已安装 Node.js；执行 node --version 检查。
2. 按下面的配置示例连接 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。

推荐操作顺序

Shortened. The full README is on GitHub.