pymgba-mcp

This is a vibecoded Python-based MCP (Model Context Protocol) server for the mGBA Game Boy/GBA emulator using native Python bindings. It interacts with mGBA through its native Python bindings, allowing not only to take screenshots but also to control the emulator, read and write memory, add breakpoints, and more - meant for vibe coding GB homebrew games.

It also ships as a Nix flake, to build mGBA and the Python bindings all together for a portable, easy to reproduce setup.

Features

• Native Python bindings: Uses mGBA's built-in Python API instead of spawning external processes

• Full emulator control: Run frames, step instructions, pause/unpause

• Memory access: Read/write memory at any address

• Button input: Press and hold Game Boy buttons

• Screenshots: Capture the screen at any time

• Save states: Save and load emulator state

• Debugging: Set breakpoints, read CPU registers, step through code

• OAM inspection: View sprite data

Related MCP server: mGBA MCP Server

Tools

Usage with your favorite vibe coding tool

Install Nix: https://nixos.org/download.html, and add to your MCP settings:

{
  "mcpServers": {
    "pymgba": {
      "command": "nix",
      "args": ["run", "github:zenitraM/pymgba-mcp"],
    }
  }
}

Running with Nix

Install Nix: https://nixos.org/download.html, clone this repo:

nix run .

Or directly from GitHub:

nix run github:zenitraM/pymgba-mcp