minecraft

This MCP server hosts a Minecraft bot powered by Mineflayer that is controlled through the Model Context Protocol (MCP). It enables Claude and other supported models to issue in-game commands to a Minecraft character, including moving, looking around, interacting with inventory and blocks, and communication with players. To use it, configure Claude Desktop (or another MCP client) to point at the server via MCP settings, then start the client so it boots the MCP server inside the Minecraft game session. Once the server is booted, you can send prompts to Claude that ask the bot to perform actions in the game. The provided command set includes movement (get-position, move-to-position, look-at, jump, move-in-direction), flight (fly-to), inventory management (list-inventory, find-item, equip-item), block interactions (place-block, dig-block, get-block-info, find-block), furnace actions (smelt-item), entity interactions (find-entity), and game-state queries (detect-gamemode), as well as chat capabilities (send-chat, read-chat). For best results, clearly describe your desired action and mention any required permissions in your prompt when using Claude Desktop.

Prerequisites:

• Git
• Node.js (>= 20.10.0)
• A running Minecraft Java Edition game (Minecraft 1.21.11 compatibility is noted; newer versions may require updates)
• An MCP-compatible client (e.g., Claude Desktop)

Installation steps:

1. Install Node.js from the official website or your system package manager.
2. Ensure Git is installed and available in your PATH.
3. Open a terminal and verify Node.js and npm:
   • node -v
   • npm -v
4. You can run the MCP server directly using npx without a local install: npx -y github:yuniko-software/minecraft-mcp-server --host localhost --port 25565 --username ClaudeBot
5. Alternatively, you can install the package locally (optional): npm install github:yuniko-software/minecraft-mcp-server node_modules/.bin/minecraft-mcp-server --host localhost --port 25565 --username ClaudeBot
6. In Claude Desktop, open File -> Settings -> Developer -> Edit Config and set the mcpServers entry as shown in the example configuration. Ensure Minecraft is running and the world is open to LAN before starting the bot.
7. Restart Claude Desktop to boot the MCP server and establish the connection to Minecraft.

Tips and known considerations:

• The MCP server is configured to connect to a Minecraft instance running on localhost (port 25565). If your setup differs, adjust the host/port accordingly.
• The initial boot may take some time; the “server booted” marker indicates readiness.
• Confirm that your client (Claude Desktop) is using an MCP-enabled workflow and that the bot has the necessary permissions in-game.
• If Minecraft version compatibility becomes an issue, check for updates to the MCP server package or adjust the version in use.
• The bot can receive commands via any active Claude chat; for complex actions, consider breaking tasks into smaller steps and verify in-game feedback.
• When upgrading or making configuration changes, fully reboot Claude Desktop to ensure the MCP server restarts cleanly.