MinecraftBuildMCP

What is MinecraftBuildMCP?

MinecraftBuildMCP is a Model Context Protocol (MCP) server that enables Claude (or other compatible LLMs) to control a Minecraft bot using the Mineflayer API. It bridges the gap between AI language models and Minecraft, allowing automated building, exploration, and interaction through natural language.

How to use MinecraftBuildMCP?

After installing Node.js v16+, clone the repository, run npm install and npm run build. Start Minecraft Java Edition 1.21.4, open a world to LAN, and note the port. Run the bot with node dist/bot.js --host localhost --port 25565 --username Bob_the_Builder. Alternatively, use npx -y github:Jeremy-Min-Yang/minecraft-mcp-server-pixel --host localhost --port 25565 --username Bob_the_Builder. Then add the corresponding MCP server configuration to your claude_desktop_config.json.

Key features of MinecraftBuildMCP

• AI-powered bot control via natural language
• Automated pixel art creation from 2D arrays
• Movement and navigation commands
• Precise block placement at specified coordinates
• Entity detection and interaction
• In-game chat send and receive
• Creative mode support including teleportation and inventory manipulation

Use cases of MinecraftBuildMCP

• Build complex pixel art designs automatically using natural language prompts
• Automate exploration and navigation of Minecraft worlds
• Interact with the environment and entities without manual control
• Create automated building workflows for large structures
• Enable AI-assisted creative mode building with inventory management

FAQ from MinecraftBuildMCP

What is MinecraftBuildMCP and how does it work?

MinecraftBuildMCP is an MCP server that connects LLMs like Claude to a Minecraft bot (powered by Mineflayer). It exposes commands for movement, block placement, entity detection, chat, and pixel art, allowing the AI to control the bot based on natural language instructions.

What are the prerequisites to run MinecraftBuildMCP?

You need Node.js v16 or higher, Minecraft Java Edition (tested on version 1.21.4), and a compatible MCP client such as Claude Desktop. Creative Mode is recommended for full functionality.

How do I integrate MinecraftBuildMCP with Claude Desktop?

Add the following entry to your claude_desktop_config.json under mcpServers: a key named "minecraft" with command npx, arguments including -y, the GitHub repository URL, and options for host, port, and username. Full example is in the README.

What commands can I use to control the bot?

Available commands include get-position, move-to-position, equip-item, get-bot-status, list-block-names, place-block, find-entity, send-chat, and build-pixel-art. Each command has specific parameters detailed in the project's schema documentation.

Does MinecraftBuildMCP support creative mode features?

Yes. Creative mode offers teleportation via move-to-position and full inventory manipulation. The recommended configuration uses Creative Mode for the best experience.