mcp-minecraft

Minecraft MCP-сервер

⚠️ ВАЖНОЕ ПРЕДУПРЕЖДЕНИЕ О СОВМЕСТИМОСТИ : по состоянию на 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)
• Клод Десктоп

Начиная

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

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

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

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

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

Дважды проверьте, что были использованы правильные параметры --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 — отправить сообщение в чате в игре

Внося вклад

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

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

• Дополнительная документация
• Более надежная обработка ошибок
• Тесты для различных компонентов
• Новые функции и команды