This project provides a Minecraft bot that leverages the Model Context Protocol (MCP) to allow AI assistants, such as Claude, to control a Minecraft character. It enables AI to perform actions like building, exploring, and interacting with the game world through natural language commands, bridging the gap between AI capabilities and interactive gaming environments.

How It Works

The bot utilizes the Mineflayer API to interface with Minecraft. It connects to a Minecraft game instance opened to LAN and communicates with an MCP-compatible client, like Claude Desktop. The Model Context Protocol facilitates the exchange of commands and game state information between the AI and the Minecraft client, allowing the AI to interpret instructions and control the in-game character's actions.

Quick Start & Requirements

• Install/Run: Configure claude_desktop_config.json with the provided JSON snippet, ensuring correct host and port. Reboot Claude Desktop.
• Prerequisites: Git, Node.js, Minecraft 1.21.6 Java Edition (or lower), and an MCP-compatible client (e.g., Claude Desktop).
• Setup: Estimated setup time is minimal, primarily involving configuration file edits and application restarts.

Highlighted Details

• Supports real-time control of a Minecraft character via natural language.
• Enables AI to build structures, explore, and interact with the game environment.
• Offers a range of commands for movement, inventory management, block interaction, entity interaction, and communication.

Maintenance & Community

The project was developed rapidly and welcomes contributions for enhancements such as additional documentation, error handling, tests, and new features. Details for contributing can be found in CONTRIBUTING.md.

Licensing & Compatibility

The repository does not explicitly state a license. Compatibility is limited to Minecraft versions 1.21.6 and lower due to ongoing development for newer versions.

Limitations & Caveats

The bot is explicitly stated to be compatible only with Minecraft 1.21.6 and lower versions; higher versions are not supported until future updates are released. The project is also noted as being developed in a short timeframe, suggesting potential areas for improvement in robustness and documentation.