Minecraft MCP-сервер

Name: mcp-minecraft
Author: yuniko-software

⚠️ ВАЖНОЕ ПРЕДУПРЕЖДЕНИЕ О СОВМЕСТИМОСТИ : по состоянию на 25 марта 2025 года Minecraft 1.21.5 был выпущен. Этот бот в настоящее время НЕ совместим с Minecraft 1.21.5. Пожалуйста, используйте Minecraft 1.21.4, пока мы не выпустим обновление с поддержкой 1.21.5.

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

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

Предпосылки

Гит
Node.js
Запущенная игра Minecraft (приведенная ниже настройка была протестирована с Minecraft 1.21.4 Java Edition, входящей в Microsoft Game Pass)
Клод Десктоп

Related MCP server: MCP Server

Начиная

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

Запустить Майнкрафт

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

Конфигурация МКП

Убедитесь, что 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 3.7 Sonnet может дать вам некоторые интересные результаты. Бот-агент был бы действительно умным 🫡

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

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

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

Движение

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-block — найти ближайший блок определенного типа

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

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

Коммуникация

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

Внося вклад

Это приложение было сделано всего за два дня, и код действительно прост и понятен. Все коммиты по рефакторингу, функциональные и тестовые вклады, проблемы и обсуждения очень приветствуются!

Не стесняйтесь отправлять запросы на включение или открывать проблемы для улучшений. Некоторые области, которые могут нуждаться в улучшении: