minecraft-mcp-server

Overview

This MCP server provides a comprehensive interface between AI models and Minecraft gameplay through the Model Context Protocol. It allows Claude and other compatible AI systems to control Minecraft characters in real-time, enabling complex interactions like building structures, exploring environments, and executing commands in the game world. The server implements various movement, inventory management, block interaction, and communication tools that map directly to Minecraft game mechanics.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get-position

  Get the current position of the bot in the Minecraft world

  Try:Where am I?Try:Tell me your current position
• move-to-position

  Move to specific coordinates in the world

  Try:Move to coordinates (100, 64, 200)Try:Go to position x=50 z=150
• look-at

  Make the bot look at specific coordinates

  Try:Look at the mountain at coordinates (120, 80, 180)Try:Face the direction of the castle
• jump

  Make the bot jump

  Try:Jump over this ravineTry:Jump 10 times
• move-in-direction

  Move in a specific direction for a duration

  Try:Move forward for 5 secondsTry:Walk north until you see water
• fly-to

  Make the bot fly directly to specific coordinates

  Try:Fly to the top of that mountainTry:Fly to coordinates (300, 120, 50)
• list-inventory

  List all items in the bot's inventory

  Try:What items do I have?Try:Show me my inventory
• find-item

  Find a specific item in inventory

  Try:Do I have any diamonds?Try:Find oak wood in my inventory
• equip-item

  Equip a specific item

  Try:Equip diamond pickaxeTry:Put on iron armor
• place-block

  Place a block at specified coordinates

  Try:Place dirt at my feetTry:Build a stone wall here
• dig-block

  Dig a block at specified coordinates

  Try:Mine the block in front of youTry:Dig down 3 blocks
• get-block-info

  Get information about a block

  Try:What block is this?Try:Identify the block at coordinates (50, 64, 100)

Comparable tools

Installation

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

FAQ

Which Minecraft versions are supported?

Currently supports Minecraft version 1.21.11. Newer versions may not work but support will be added as soon as possible.

Can I use this with AI clients other than Claude?

Yes, this MCP server is designed to work with any MCP-compatible client, not just Claude Desktop.

Compare minecraft-mcp-server with