MCP.so
Sign In

Minecraft MCP Server

@yuniko-software

Basic information

Category

Developer Tools

Last updated

License

Apache-2.0

Transports

stdio

Author

yuniko-software

About Minecraft MCP Server

A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction

Minecraft MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Minecraft MCP Server tools

22

Get the current position of the bot

Move the bot to a specific position

Make the bot look at a specific position

Make the bot jump

Move the bot in a specific direction for a duration

List all items in the bot's inventory

Find a specific item in the bot's inventory

Equip a specific item

Place a block at the specified position

Dig a block at the specified position

Get information about a block at the specified position

Find one or more nearby blocks of a specific type

Find the nearest entity of a specific type

Send a chat message in-game

Get recent chat messages from players

Make the bot fly to a specific position

Detect the gamemode on game

List all available crafting recipes the bot can make with current inventory

Craft an item using a crafting recipe

Get detailed information about a specific recipe

Check if the bot can craft a specific item with current inventory

Smelt items using a furnace-like block

Overview

What is Minecraft MCP Server?

A Minecraft bot powered by large language models and the Mineflayer API. It uses the Model Context Protocol (MCP) to enable Claude and other supported models to control a Minecraft character in-game.

How to use Minecraft MCP Server?

Install Node.js 20.10.0 or later, run Minecraft and open a singleplayer world to LAN, then configure an MCP‑compatible client (e.g., Claude Desktop) with a claude_desktop_config.json that runs the npx command with host, port, and username arguments. Start the client; the bot will join the game automatically.

Key features of Minecraft MCP Server

  • Movement commands: get-position, move-to, look-at, jump, move-in-direction.
  • Flight: fly-to command for direct aerial movement.
  • Inventory management: list, find, and equip items.
  • Block interaction: place, dig, get info, and find nearby

Comments

More Developer Tools MCP servers