Pcsx2 MCP

PCSX2-MCP

PCSX2改装及MCP服务器

通过AI编码助手控制PS2模拟器。 设置断点、读取寄存器、反汇编MIPS、检查内存——所有这些都是通过MCP工具完成的。

┌─────────────┐    stdio (MCP)    ┌─────────────────────┐    TCP:21512    ┌─────────────────┐
│ AI Assistant │ ◄──────────────► │  pcsx2-mcp-server   │ ◄────────────► │  PCSX2 Emulator │
│ (Antigravity │                  │  (Node.js bridge)    │                │  + DebugServer   │
│  Claude etc) │                  │                      │ ◄────────────► │  + Pine IPC      │
└─────────────┘                  └─────────────────────┘    TCP:28011    └─────────────────┘

______________________________________________________________________

⚠️ 存储库与发布版——先读一下

此git仓库不包含完整的PCSX2源代码。 我们只提供修改的来源，以避免浪费存储空间上传1GB的上游代码。

只想使用它吗？ → 下载 最新版本 拉链。一切都是预先构建的。

想要修改或重建吗？ → 克隆此仓库，然后按照以下步骤操作 从源头构建 在......下面

______________________________________________________________________

快速入门（3个步骤）

1.下载

获取最新版本 --把拉链拉到任何地方。

2.设置

跑 setup-mcp.bat --它检查Node.js并为您编写MCP配置。

需要 ≥ 18. 安装脚本会告诉你它是否丢失。

3.使用

1. 发射 pcsx2-qt.exe 从提取的文件夹中
2. 加载PS2游戏（ISO或光盘）
3. 重启你的人工智能助手（反重力/克劳德桌面）
4. 问： *“连接到PCSX2并向我显示线程列表”*

就是这样！你的AI助手现在已经 30个调试工具 对于PS2。

______________________________________________________________________

手动MCP配置

如果 setup-mcp.bat 不起作用或您想手动配置：

Antigravity / Gemini

编辑 ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "pcsx2": {
      "command": "node",
      "args": ["
/pcsx2-mcp-server/dist/index.js"],
      "disabled": false
    }
  }
}

Claude Desktop

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "pcsx2": {
      "command": "node",
      "args": ["
/pcsx2-mcp-server/dist/index.js"]
    }
  }
}

VS Code (Copilot / Continue.dev)

创建 .vscode/mcp.json 在您的项目中：

{
  "servers": {
    "pcsx2": {
      "command": "node",
      "args": ["
/pcsx2-mcp-server/dist/index.js"]
    }
  }
}

______________________________________________________________________

里面有什么

DebugServer（内置于PCSX2中）

注入PCSX2的自定义TCP服务器，用于监听 端口21512。当模拟器启动时，您将看到：

[DebugServer] Listening on 127.0.0.1:21512

MCP服务器（Node.js网桥）

将MCP工具调用转换为DebugServer TCP命令。还支持 松树IPC （端口28011）作为基本存储器R/W和保存状态的回退。

______________________________________________________________________

全部30个工具

连接和状态

记忆

寄存器

反汇编

断点和观察点

执行控制

系统

PS2恢复集成

______________________________________________________________________

示例工作流程

逆向工程功能

> "Connect to PCSX2"
> "Disassemble 40 instructions at 0x001000E0"
> "Set breakpoint at 0x001000E0 with condition v0 == 5"
> "Continue and wait for breakpoint"
> "Read registers"
> "Read 256 bytes at the address in a0"

使用差分查找内存值

> "Take a memory snapshot of 0x200000, size 4096"
  (do something in the game)
> "Diff the snapshot to find changes"

使用调用堆栈调试崩溃

> "Pause the emulator"
> "Get the backtrace"
> "Disassemble the function at entry 0x00125bf4"
> "Read registers to see what went wrong"

与PS2Recomp相比

> "Look up function at 0x0072e5c0 in PS2Recomp"
> "Set breakpoint at 0x0072e5c0 in PCSX2"
> "Step through and compare register values"

______________________________________________________________________

建筑

Git仓库

PCSX2-MCP/                       ← source code only, lightweight
├── pcsx2-plugin/
│   ├── DebugServer.cpp          ← our custom patch for PCSX2 (this is the only PCSX2 modification)
│   └── DebugServer.h
├── pcsx2-mcp-server/
│   ├── src/index.ts             ← MCP server source (TypeScript)
│   ├── src/debug-server-client.ts
│   ├── src/pine-client.ts
│   ├── package.json
│   └── tsconfig.json
├── README.md
├── setup-mcp.bat
└── package-release.ps1

GitHub发布（zip）

PCSX2-MCP-v1.0.0-win64/          ← ready to run, everything pre-built
├── pcsx2-qt.exe                 ← PCSX2 with DebugServer already compiled in
├── *.dll                        ← Qt + runtime dependencies
├── platforms/                   ← Qt platform plugins
├── resources/                   ← PCSX2 shaders, GameDB, etc
├── pcsx2-mcp-server/
│   ├── dist/index.js            ← compiled MCP server
│   └── node_modules/            ← pre-installed dependencies
├── source/
│   ├── DebugServer.cpp          ← patch source (GPL compliance)
│   └── DebugServer.h
├── setup-mcp.bat
└── README.md

______________________________________________________________________

从源头构建

Only needed if you want to modify PCSX2 or the MCP server

先决条件

所有MCP服务器依赖项(@modelcontextprotocol/sdk, zod, typescript)在声明中 package.json 并由自动安装 npm install确实如此 不 需要手动安装它们。

PCSX2

# 1. Clone the upstream PCSX2 source (we don't include it in this repo to save space)
git clone https://github.com/PCSX2/pcsx2.git pcsx2-src
cd pcsx2-src

# 2. Copy our DebugServer patch into the PCSX2 source tree
cp ../pcsx2-plugin/DebugServer.cpp pcsx2/DebugTools/
cp ../pcsx2-plugin/DebugServer.h pcsx2/DebugTools/

# 3. Add to CMakeLists.txt (in pcsx2/DebugTools/)
# Add DebugServer.cpp and DebugServer.h to the source list

# 4. Build with CMake + Ninja + MSVC
cmake -G Ninja -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --target pcsx2-qt

MCP服务器

cd pcsx2-mcp-server

# Install all dependencies (MCP SDK, Zod, TypeScript, etc.)
npm install

# Compile TypeScript → dist/index.js
npm run build

______________________________________________________________________

故障排除

______________________________________________________________________

许可证

• PCSX2：GPL-3.0（与 上游)
• DebugServer插件：GPL-3.0（衍生作品）
• MCP服务器：MIT

GitHub版本包括一个预构建的PCSX2二进制文件（GPL-3.0）。我们修改的完整来源见 pcsx2-plugin/ （此仓库）并捆绑在发布压缩包中 source/未经修改的PCSX2源可在以下网址获得 .