Turning your LLM into a Minecraft laborer
It bridges large language models and Minecraft so AI assistants can build, dig, and explore via natural language commands.

What it does
This MCP server wraps the Mineflayer API to expose a Minecraft Java bot to LLM clients such as Claude. Once connected to an open LAN world, it translates natural-language prompts into in-game actions—movement, building, digging, inventory management, furnace use, and chat. You can even upload images of structures and ask the bot to reconstruct them.
The interesting bit
It is largely glue between Mineflayer and the Model Context Protocol, but that glue turns a local Minecraft session into an embodied playground for LLMs without server mods or protocol hacks. The bot joins a standard singleplayer LAN world and gains access to flight, block placement, and smelting through conversational commands.
Key highlights
- Targets Minecraft Java Edition 1.21.11; newer versions are explicitly not guaranteed to work
- Exposes bot actions for movement, flight, inventory, block interaction, furnace use, entity detection, chat, and game-state checks
- Accepts image uploads as references for building structures
- Connects to a standard singleplayer LAN world; no dedicated server or plugins required
- Compatible with any MCP client, though Claude Desktop is the primary documented target
Caveats
- Booting the MCP server inside Claude Desktop can take some time
- Version lock to 1.21.11 means minor Minecraft updates may break the integration
- The documented workflow assumes a local singleplayer world opened to LAN
Verdict
A fun sandbox for developers experimenting with LLM agents in 3D environments. Not the tool for headless server automation or players on the latest Minecraft snapshots.
Frequently asked
- What is yuniko-software/minecraft-mcp-server?
- It bridges large language models and Minecraft so AI assistants can build, dig, and explore via natural language commands.
- Is minecraft-mcp-server open source?
- Yes — yuniko-software/minecraft-mcp-server is open source, released under the Apache-2.0 license.
- What language is minecraft-mcp-server written in?
- yuniko-software/minecraft-mcp-server is primarily written in TypeScript.
- How popular is minecraft-mcp-server?
- yuniko-software/minecraft-mcp-server has 669 stars on GitHub.
- Where can I find minecraft-mcp-server?
- yuniko-software/minecraft-mcp-server is on GitHub at https://github.com/yuniko-software/minecraft-mcp-server.