dmang-dev/mcp-dolphin

Overview

An MCP server that interfaces with a Python-scriptable fork of the Dolphin emulator, enabling read/write access to GameCube and Wii memory, controller input, savestate management, and frame advance. It uses TypeScript to expose these emulator capabilities as tools for AI agents.

Best for

Best for
Developers building AI-assisted tooling for emulator-based game testing, TAS creation, or memory analysis on GameCube/Wii

Use cases

• Automate memory editing and savestate loading for speedrun testing
• Script controller inputs and frame-advance for TAS (tool-assisted speedrun) creation
• Build AI agents that interact with emulated GameCube/Wii games in real time

How to use

Install

npx -y mcp-dolphin --print-bridge > mcp_bridge.py

Tools exposed

• dolphin_ping
• dolphin_get_info
• dolphin_read_range
• dolphin_press_gc_buttons
• dolphin_press_wiimote_buttons
• dolphin_set_wiimote_pointer
• dolphin_set_wiimote_acceleration
• dolphin_set_wiimote_angular_velocity
• dolphin_reset
• dolphin_frame_advance
• DOLPHIN_BRIDGE_HOST
• DOLPHIN_BRIDGE_PORT
• DOLPHIN_TIMEOUT_MS
• MCP_DOLPHIN_DEBUG

Tested with

Claude Desktop, Claude Code

Notes

An MCP server that interfaces with a Python-scriptable fork of the Dolphin emulator, enabling read/write access to GameCube and Wii memory, controller input, savestate management, and frame advance. It uses TypeScript to expose these emulator capabilities as tools for AI agents.

0 stars on GitHub. Last updated 2026-06-11. Licensed MIT.

Use cases

• Automate memory editing and savestate loading for speedrun testing
• Script controller inputs and frame-advance for TAS (tool-assisted speedrun) creation
• Build AI agents that interact with emulated GameCube/Wii games in real time

Pros

• Direct low-level access to emulator internals (memory, savestates, frame advance)
• Leverages Felk’s well-maintained Python-scripting Dolphin fork for reliability
• TypeScript MCP server integrates easily with existing MCP-compatible AI toolchains

Cons

• Requires a specific Dolphin fork (Felk’s Python-scripting version), not stock Dolphin
• Zero stars and no community adoption yet, so support and stability are unproven
• Limited to GameCube and Wii titles only, no other platforms

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.