← all repositories
yuniko-software/minecraft-mcp-server

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.

669 stars TypeScript AgentsCoding Assistants
minecraft-mcp-server
Not currently ranked — collecting fresh signals.
star history

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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.