Bevy BRP MCP

by natepiano

Not rated
GitHub

About

Control, inspect, and mutate Bevy applications with AI coding assistants via the Bevy Remote Protocol (BRP).

Details

Author
natepiano
Categories
Developer Tools, Other

Setup

Install Bevy BRP MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/natepiano/bevy_brp_mcp-ARCHIVED

Follow the installation instructions in the repository README, then restart your MCP client.

⚠️ ARCHIVED - This repository has been moved!

This repository is archived and no longer maintained.

Development has moved to the unified workspace at:https://github.com/natepiano/bevy_brp

Thebevy_brp_mcpcrate is now maintained as part of the workspace at:https://github.com/natepiano/bevy_brp/tree/main/mcp

- Update your dependencies to use the crate from the new location
- All existing functionality has been preserved
- The crate is still published to crates.io asbevy_brp_mcp

- Please submit all issues and PRs to the new repository:https://github.com/natepiano/bevy_brp
- Git history has been preserved via subtree merge

A Model Context Protocol (MCP) server that enables AI coding assistants to control launch, inspect and mutate Bevy applications via the Bevy Remote Protocol (BRP). This tool bridges the gap between coding agents and Bevy by providing comprehensive BRP integration as an MCP server.

The bevy_brp_mcp crate follows Bevy's version numbering and releases new versions for each Bevy release.

- Entity Management: Create, destroy, query, and modify entities
- Component Operations: Get, insert, remove, and mutate components on entities
- Resource Management: Access and modify global resources
- Query System: Advanced entity querying with filters
- Hierarchy Operations: Parent-child entity relationships

- App Discovery: Find and list Bevy applications in your workspace
- Build Status: Check which apps are built and ready to run
- Launch Management: Start apps with proper asset loading and logging
- Example Support: Discover and run Bevy examples from your projects

- Component Watching: Monitor component changes on specific entities
- Log Management: Centralized logging for all launched applications
- Process Status: Check if apps are running with BRP enabled

- Format Discovery: Get correct JSON formats for BRP operations (via bevy_brp_extras)
- Screenshot Capture: Take screenshots of running Bevy applications
- Keyboard Input: Send keyboard input to Bevy applications for testing and automation
- Key Code Discovery: List all available keyboard key codes for input operations
- Graceful Shutdown: Clean application termination

first, install via cargo:cargo install bevy_brp_mcp

configure your mcp server - for claude code this would be in the~/.claude.jsonfile.

"mcpServers": { "brp": { "type": "stdio", "command": "bevy_brp_mcp", "args": [], "env": {} } },

bevy_brp_mcp is designed to be used with AI coding assistants that support MCP (like Claude). The MCP server provides tools that allow the AI to:
- Discover and launch your Bevy applications - with logs stored in your temp dir so they can be accessed by the coding assistant.
- Inspect and modify entity components in real-time
- Monitor application state and debug issues
- Take screenshots and manage application lifecycle (requriesbevy_brp_extras)

For full functionality, your Bevy app should include BRP support:

use bevy::prelude::; fn main() { App::new() .add_plugins(DefaultPlugins) .add_plugins(bevy::remote::RemotePlugin::default()) // Enable BRP .run(); }

For enhanced features like screenshots and format discovery, also addbevy_brp_extras:

use bevy::prelude::; use bevy_brp_extras::BrpExtrasPlugin; fn main() { App::new() .add_plugins(DefaultPlugins) .add_plugins(BrpExtrasPlugin) // Enhanced BRP features .run(); }

In either case you'll need to make sure to enable bevy's "bevy_remote" feature.

This crate is designed to work seamlessly withbevy_brp_extras. When both are used together:
- AddBrpExtrasPluginto your Bevy app for enhanced BRP features
- Usebevy_brp_mcpwith your AI coding assistant
- Additional methods like screenshot, shutdown, and format discovery will be automatically available
- Get proper JSON formats for complex BRP operations. The brp_extras/discover_format feature is especially useful. The value returned from bevy/registry/schema does not tell you exactly what is expected by the brp spawn/insert/mutate calls. As a result your coding agent will engage in trial and error to figure it out but it's not 100% reliable.

If you have bevy_brp_extras installed, it can get the type information directly from the running app andand provide it if queried via brp_extras/discover_format - or it will provide it in the error message if your coding agent tries a call and fails.
- Discovery: Uselist_bevy_appsto find available applications
- Launch: Uselaunch_bevy_appto start your game with proper logging
- Inspect: Usebevy_queryto find entities of interest
- Monitor: Usebrp_get_watchto observe entity changes in real-time
- Modify: Usebevy_mutate_componentto adjust entity properties
- Debug: Useread_logto examine application output
- Capture: Usebrp_extras_screenshotto document current state
- Interact: Usebrp_extras_send_keysto send keyboard input for testing

All launched applications create detailed log files in/tmp/with names like:

- bevy_brp_mcp_myapp_1234567890.log(application logs)
- bevy_brp_mcp_watch_123_get_456_1234567890.log(monitoring logs)

Use the log management tools to view and clean up these files.

- MIT license (LICENSE-MITorhttp://opensource.org/licenses/MIT)
- Apache License, Version 2.0 (
LICENSE-APACHEorhttp://www.apache.org/licenses/LICENSE-2.0)

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

An MCP server for AI coding assistants to control, inspect, and modify Bevy applications using the Bevy Remote Protocol (BRP).

A server for Ebitengine games that provides debugging and recording tools by capturing game state.

Fennara MCP connects AI agents like Codex, Cursor, Claude Code, and Claude Desktop to Godot-aware tools for real Godot projects. It focuses on feedback from Godot: GDScript diagnostics, scene validation, runtime errors, scene inspection, node properties, screenshots, SemanticSearch, and patch-and-rerun workflows.

The most comprehensive MCP server for Godot Engine. 95+ tools for scene management, GDScript LSP, DAP debugging, screenshot capture, input injection, and CC0 asset library.

AI-powered live runtime debugging with Lightrun production context.

Run, debug, and triage tests via natural language across HyperExecute, Automation, SmartUI, and Accessibility on the TestMu AI cloud.

Understand, develop, and debug authorization policies in Oso Cloud.

A comprehensive proxy that combines multiple MCP servers into a single MCP. It provides discovery and management of tools, prompts, resources, and templates across servers, plus a playground for debugging when building MCP servers.

Proxyman MCP allows AI to inspect HTTP traffic, create debugging rules, and control Proxyman - all through natural language conversations.

Debug your remote Node.js and Next.js applications directly from your AI IDE like Cursor.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.