Minecraft MCP-сервер

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

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

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

• Git

• Node.js (>= 20.10.0)

• Запущенная игра Minecraft (настройка ниже была протестирована с Minecraft 1.21.8 Java Edition, входящей в состав Microsoft Game Pass)

• MCP-совместимый клиент. В качестве примера будет использоваться Claude Desktop, но поддерживаются и другие MCP-клиенты

Related MCP server: MCP Server

Начало работы

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

Запуск Minecraft

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

Настройка MCP

Убедитесь, что Claude Desktop установлен. Откройте File -> Settings -> Developer -> Edit Config. Должна открыться директория установки. Найдите файл с именем claude_desktop_config.json и вставьте следующий код:

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

Дважды проверьте, что были использованы правильные параметры --port и --host. Обязательно полностью перезапустите приложение Claude Desktop (оно должно быть закрыто в системном трее).

Запуск

Убедитесь, что игра Minecraft запущена и мир открыт для локальной сети. Затем запустите приложение Claude Desktop, и бот должен присоединиться к игре.

Claude Desktop может потребоваться некоторое время для запуска MCP-сервера. Признак того, что сервер успешно запущен:

Вы можете отдавать боту любые команды через любой активный чат Claude Desktop. Вы также можете загружать изображения построек и просить бота построить их 😁

Не забудьте упомянуть в своем запросе, что бот должен что-то сделать в Minecraft. Поскольку это является триггером для запуска MCP-сервера. Он запросит у вас разрешения.

Использование Claude Sonnet может дать вам интересные результаты. Бот-агент будет по-настоящему умным 🫡

Пример использования: общий чат Claude

Доступные команды

После подключения к серверу Minecraft Claude может использовать следующие команды:

Передвижение

• get-position — получить текущую позицию бота

• move-to-position — переместиться к указанным координатам

• look-at — заставить бота посмотреть на указанные координаты

• jump — заставить бота прыгнуть

• move-in-direction — двигаться в заданном направлении в течение определенного времени

Полет

• fly-to — заставить бота лететь прямо к указанным координатам

Инвентарь

• list-inventory — перечислить все предметы в инвентаре бота

• find-item — найти определенный предмет в инвентаре

• equip-item — экипировать определенный предмет

Взаимодействие с блоками

• place-block — разместить блок по указанным координатам

• dig-block — сломать блок по указанным координатам

• get-block-info — получить информацию о блоке

• find-blocks — найти один или несколько ближайших блоков определенного типа

Печь

• smelt-item — переплавить предметы, используя блок типа печи

Взаимодействие с сущностями

• find-entity — найти ближайшую сущность определенного типа

Общение

• send-chat — отправить сообщение в игровой чат

• read-chat — получить последние сообщения чата от игроков

Состояние игры

• detect-gamemode — определить игровой режим в игре

Участие в разработке

Не стесняйтесь отправлять pull-реквесты или открывать issues для улучшений. Любые коммиты по рефакторингу, функциональные и тестовые вклады, вопросы и обсуждения очень приветствуются!

Чтобы начать помогать проекту, пожалуйста, ознакомьтесь с CONTRIBUTING.md.

⭐ Если вы находите этот проект полезным, пожалуйста, поставьте ему звезду на GitHub! ⭐

Ваша поддержка помогает сделать этот проект более заметным для других людей, которым он может быть полезен.