mcp-dolphin
An MCP server for Dolphin (GameCube + Wii) — drives memory r/w, controller input (GameCube + Wii Remote), pause/resume/reset, savestates, and frame advance from MCP-compatible clients (Claude Desktop, Claude Code, etc.).
What you can do with it
- Read & write emulated PowerPC memory — 8/16/32/64-bit, MEM1 + MEM2
- Send controller input — GameCube (digital + analog sticks + triggers), Wii Remote (buttons + IR pointer + accelerometer + MotionPlus angular velocity)
- Reset the emulator (pause/resume not in v0.1.0 — see Known limitations)
- Save / load state to numbered slots (0-255; 1-10 map to F1-F10 in Dolphin)
- Frame advance — wait N frames synchronously for TAS-style precision
Not yet wired in v0.1.0 (deferred to a later release):
- Wii Remote motion (pointer, accelerometer, swing, shake, tilt)
- Nunchuk / Classic Controller / GBA-via-Wii input
- Memory breakpoints, register access, screenshots
Architecture (and the hard prerequisite)
┌─────────────────────────────────────────────────┐
│ Dolphin (Felk's fork — required, not mainline) │
│ │
│ mcp_bridge.py loaded via Scripting panel │
│ └─ TCP server on 127.0.0.1:55355 │
└─────────────────────────────────────────────────┘
↕ TCP loopback (newline-delimited JSON)
┌─────────────────────────────────────────────────┐
│ mcp-dolphin (Node.js — this package) │
└─────────────────────────────────────────────────┘
↕ MCP stdio
MCP client (Claude etc.)





