dmang-dev/mcp-ppsspp

Overview

An MCP server that connects to PPSSPP's built-in WebSocket debugger, allowing you to control PSP games programmatically. It exposes actions like loading save states, sending button inputs, and reading emulator state through the Model Context Protocol.

Best for

Best for
Developers experimenting with emulator automation or building AI agents for PSP game interaction

Use cases

• Automate PSP game testing by scripting save state loads and input sequences
• Build AI agents that can play or analyze PSP games via PPSSPP
• Integrate PPSSPP debugging into larger toolchains for emulator research

How to use

Install

npm install -g mcp-ppsspp

Tools exposed

• PPSSPP_HOST
• PPSSPP_PORT
• ppsspp_ping
• ppsspp_get_info
• ppsspp_read_range
• ppsspp_write_range
• ppsspp_read_string
• ppsspp_press_buttons
• ppsspp_press_button
• ppsspp_send_analog
• ppsspp_step
• ppsspp_reset
• ppsspp_screenshot
• ppsspp_get_registers

Tested with

Claude Desktop, Claude Code

Notes

An MCP server that connects to PPSSPP’s built-in WebSocket debugger, allowing you to control PSP games programmatically. It exposes actions like loading save states, sending button inputs, and reading emulator state through the Model Context Protocol.

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

Use cases

• Automate PSP game testing by scripting save state loads and input sequences
• Build AI agents that can play or analyze PSP games via PPSSPP
• Integrate PPSSPP debugging into larger toolchains for emulator research

Pros

• Leverages PPSSPP’s official WebSocket debugger for reliable control
• Written in TypeScript with clear MCP integration patterns
• Small, focused codebase easy to extend or audit

Cons

• Very early stage with only 2 GitHub stars and limited community validation
• Requires PPSSPP running with WebSocket debugger enabled and configured
• No documentation beyond the README; may lack error handling for edge cases

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