Control a Minecraft character in real-time through natural language. Enables AI assistants to build structures, explore, and interact with the game environment.
642+ GitHub stars
Open source under Apache-2.0 license — free to use and modify
MCP server allowing AI to control Minecraft character in real-time
Minecraft MCP Server connects AI assistants directly to a running Minecraft Java Edition game. Install the server, configure your MCP client (e.g., Claude Desktop), and start controlling a bot character with natural language. The bot can build structures, explore terrain, gather resources, and interact with the world autonomously. Powered by Mineflayer API and the Model Context Protocol, it supports Minecraft 1.21.11 and requires Node.js 20+. Best for developers and gamers who want to automate tasks or experiment with LLM-controlled agents inside Minecraft.
Currently the server supports Minecraft 1.21.11 (Java Edition). Newer versions may not work, but we will add support as soon as possible.
The bot is designed to connect to LAN worlds opened from a singleplayer game. For dedicated servers, you may need to adjust the host and port configuration, but it's not officially supported yet.
You can set the bot username via the `--username` argument in the MCP configuration. For custom behavior, you can extend the bot's capabilities by modifying the code or using additional MCP prompts.
Install Minecraft MCP Server to get started:
Or visit the project page for detailed setup instructions.