Minecraft MCP

Minecraft MCP is an MCP server that connects large language model interfaces like Claude Desktop to a live Minecraft game environment using the Mineflayer API. Designed for developers, researchers, and gaming enthusiasts, this server allows AI assistants to navigate, manipulate, and inspect the game world directly through natural language instructions. The integration translates chat prompts into real-time in-game actions executed by a persistent bot character. Users can instruct the bot to gather spatial information, traverse terrain, manage inventory, manipulate blocks, and operate furnaces. It also supports conversational monitoring through reading and dispatching in-game chat messages. By bridging the Model Context Protocol with Mineflayer, the server allows Claude to analyze the Minecraft environment, parse surroundings, search for specific entities or block types, and even execute multi-step construction tasks based on text or uploaded reference images. It was tested on Minecraft Java Edition version 1.21.11.

Category: Other & General Purpose

Tags: automation, game-engine, gaming, minecraft

Visit Minecraft MCP

How to install and configure Minecraft MCP

1. Ensure Git, Node.js (version 20.10.0 or higher), and Minecraft Java Edition are installed. 2. Start a Minecraft singleplayer world and open it to LAN via ESC -> Open to LAN, ensuring it runs on port 25565. 3. Open Claude Desktop, navigate to File -> Settings -> Developer -> Edit Config, and open claude_desktop_config.json. 4. Add the server entry: json { "mcpServers": { "minecraft": { "command": "npx", "args": [ "-y", "github:yuniko-software/minecraft-mcp-server", "--host", "localhost", "--port", "25565", "--username", "ClaudeBot" ] } } } 5. Fully quit Claude Desktop from the system tray and restart it.

What you can do with Minecraft MCP

• Instructing the bot character to dig, position, and place blocks to recreate structures from user-provided images. - Navigating across coordinates, jumping obstacles, and flying directly to specific locations in the game world. - Managing player inventory, finding specific items, equipping armor or tools, and automating furnace smelting operations. - Scanning nearby terrain to find specific blocks or detect the nearest game entities like animals and monsters. - Monitoring game events by reading chat logs and sending automated in-game chat messages to other players.

Key facts

• https://github.com/yuniko-software/minecraft-mcp-server
• Other & General Purpose
• automation, game-engine, gaming, minecraft

Part of MCP Servers

How do I install Minecraft MCP?

You can install and run Minecraft MCP by adding it to your Claude Desktop configuration file. Ensure Node.js 20.10.0 or higher is installed, open your singleplayer Minecraft world to LAN on port 25565, and configure the server in claude_desktop_config.json using npx to pull github:yuniko-software/minecraft-mcp-server with host, port, and username arguments.

What can Minecraft MCP do?

Minecraft MCP allows AI assistants to control a Minecraft bot via Mineflayer. Claude can inspect player coordinates, move, jump, fly, list and equip inventory items, dig and place blocks, detect nearby entities, run smelting tasks in furnaces, detect the current gamemode, and send or read in-game chat messages.

Which MCP clients work with Minecraft MCP?

Minecraft MCP works with Claude Desktop and other MCP-compliant client applications. The setup documentation specifies configuration instructions for Claude Desktop, but any client capable of running local process-based Model Context Protocol servers over standard input and output can communicate with the server.

Which Minecraft versions are supported by Minecraft MCP?

The server currently supports Minecraft version 1.21.11 Java Edition, with documented testing on version 1.21.8. Newer or different Minecraft releases might not function properly until upstream Mineflayer compatibility updates are integrated into the repository.