---

[! ВАЖНО] В настоящее время поддерживает Minecraft версии 1.21.11. Новые версии могут не работать с этим MCP-сервером, но мы добавим поддержку как можно скорее.

https://github.com/user-attachments/assets/6f17f329-3991-4bc7-badd-7cde9aacb92f

Бот Minecraft, работающий на больших языковых моделях и API Mineflayer. Этот бот использует протокол Model Context Protocol (MCP), чтобы Клод и другие поддерживаемые модели могли управлять персонажем Minecraft.

Предварительные требования

• Иди
• Node.js (>= 20.10.0)
• Запущенная игра Minecraft (приведённая ниже настройка была протестирована с Java Edition Minecraft 1.21.8 в Microsoft Game Pass)
• Клиент, совместимый с MCP. В качестве примера будет использован Claude Desktop, но поддерживаются и другие клиенты MCP

Начало

Этот бот предназначен для использования с Claude Desktop через протокол Model Context Protocol (MCP).

Запускайте Minecraft

Создайте одиночный мир и откройте его в LAN (ESC -> Open to LAN). Бот попытается подключиться через порт 25565 и имя хоста localhost. Эти параметры можно настроить в claude_desktop_config.json на следующем этапе.

Конфигурация MCP

Убедитесь, что Claude Desktop установлен.

Minecraft MCP Server

---

[!IMPORTANT] Currently supports Minecraft version 1.21.11. Newer versions may not work with this MCP server, but we will add support as soon as possible.

https://github.com/user-attachments/assets/6f17f329-3991-4bc7-badd-7cde9aacb92f

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

Prerequisites

• Git
• Node.js (>= 20.10.0)
• A running Minecraft game (the setup below was tested with Minecraft 1.21.8 Java Edition included in Microsoft Game Pass)
• An MCP-compatible client. Claude Desktop will be used as an example, but other MCP clients are also supported

Getting started

This bot is designed to be used with Claude Desktop through the Model Context Protocol (MCP).

Run Minecraft

Create a singleplayer world and open it to LAN (ESC -> Open to LAN). Bot will try to connect using port 25565 and hostname localhost. These parameters could be configured in claude_desktop_config.json on a next step.

MCP Configuration

Make sure that Claude Desktop is installed. Open File -> Settings -> Developer -> Edit Config. It should open installation directory. Find file with a name claude_desktop_config.json and insert the following code:

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

Double-check that right --port and --host parameters were used. Make sure to completely reboot the Claude Desktop application (should be closed in OS tray).

Running