Minecraft MCP Server

Install

Works in

• Claude Desktop
• SourceCraft
• Koda
• Coddy

Manual install

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

What it does

The server runs a Mineflayer-based Minecraft bot and hands control of it to an agent over MCP. The bot joins your world opened to LAN and follows natural-language commands: move to coordinates, fly, look at a point, jump, dig and place blocks, find blocks and entities, manage the inventory, smelt items, send and read chat, and detect the game mode. You can upload an image of a build and ask the bot to reproduce it. The connection is set through host, port and username in the client config.

Who it is for. For developers and enthusiasts who want to control a Minecraft character through an agent.

Example request

In Minecraft, move to coordinates 100, 64, 200 and build a three by three stone wall there

MCP

Transport

stdio

Authentication

not required

Limitations

You need Node.js 20.10 or newer, Git and a running Minecraft Java Edition with a world opened to LAN. The README notes support for a specific game version; newer ones may not work. By default the bot connects to localhost and port 25565, and parameters are set in the client config. The sample setup targets Claude Desktop.

How to disable. Remove the server entry from your MCP client config and fully restart the application.

README in short

The README explains that a Mineflayer bot is controlled by large language models over MCP and is aimed at Claude Desktop. It shows the steps: open a world to LAN, paste a config with npx github:yuniko-software/minecraft-mcp-server and host, port, username parameters, and restart the client. It lists commands for movement, flight, inventory, blocks, furnaces, entities, chat and game state. It notes support for a specific Minecraft version. Apache-2.0 licensed.