Minecraft MCP Server

Install

Manual install

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

This is third-party code. Review the repository files before installing.

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

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.

MCP

Transport

stdio

Authentication

not required

Security check

• Controls a bot in your Minecraft world and changes the game environment
• Downloads and runs code via npx

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.

Related