Bevy Debugger MCP

What it does

Connects AI agents (like Claude Code) to a running Bevy game engine via the Bevy Remote Protocol (BRP). This allows developers to query game state, inspect ECS components, and manipulate entities using natural language commands during runtime.

Tools

• observe: Monitor game entities, components, and resources in real-time.
• experiment: Test game behavior changes with automatic rollback.
• stress: Identify performance bottlenecks and run stress tests.
• anomaly: Spot unusual patterns in game behavior and memory leaks.
• replay: Record and replay debugging sessions.
• hypothesis: Test specific assumptions about game behavior.
• screenshot: Capture game window visuals for visual debugging.

Installation

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "bevy-debugger": {
      "command": "bevy-debugger-mcp",
      "args": ["--stdio"],
      "env": {
        "BEVY_BRP_HOST": "localhost",
        "BEVY_BRP_PORT": "15702"
      }
    }
  }
}

Supported hosts

• Claude Desktop
• Claude Code