MCP Minecraft Remote

Этот проект вдохновлен mcp-minecraft от arjunkmrm. В то время как оригинал поддерживал только локальные соединения с сервером Minecraft, этот проект был создан заново с нуля, чтобы добавить поддержку для подключения к удаленным серверам Minecraft.

Удаленное управление Minecraft с использованием MCP (Model Context Protocol).

Функции

• Подключитесь к игроку Minecraft и управляйте им с помощью помощника на основе искусственного интеллекта.

• Перемещайтесь, добывайте ресурсы, стройте и взаимодействуйте с миром Minecraft.

• Общайтесь с другими игроками на сервере

• Проверьте инвентарь, позицию игрока и информацию о сервере

• Расширенный контроль движений, включая прыжки, подкрадывание и бег

• Взаимодействие сущностей, включая нападение и преследование

• Использование контейнеров (ящики, печи и т. д.)

• Изготовление предметов и торговля с жителями деревни

• Детальное управление запасами

Установка

Быстрая установка (рекомендуется)

Следуйте инструкциям CLI для завершения настройки.

Ручная установка

Использование

Использование с Claude Desktop

1. Перейдите к файлу конфигурации Claude Desktop:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Добавьте конфигурацию Minecraft Remote MCP в ваш файл конфигурации:

Если вы установили его глобально:

Если вы клонировали репозиторий локально:

3. Сохраните файл и перезапустите Claude Desktop.

4. Начните новый разговор с Клодом и начните использовать команды управления Minecraft.

Важные требования к серверу

• Режим сервера Online : сервер Minecraft должен иметь online-mode=false установленный в файле server.properties. Это позволяет боту подключаться без аутентификации к серверам сеансов Minecraft.

• При использовании сервера с аутентификацией при подключении вам необходимо будет предоставить действительные данные премиум-аккаунта.

Доступные инструменты

Основная функциональность

• connectToServer : подключиться к серверу Minecraft с указанными учетными данными

• disconnectFromServer : Отключиться от сервера Minecraft

• sendChat : Отправить сообщение чата на сервер

• getServerInfo : Получить информацию о подключенном сервере

Движение

• getPosition : Получить текущую позицию игрока

• moveTo : Переместиться к определенным координатам

• moveControl : основные элементы управления движением (вперед, назад, влево, вправо, прыжок, бег, подкрадывание, остановка)

• lookAt : заставить игрока посмотреть в определенном направлении или на координаты

Мировое взаимодействие

• digBlock : Добыть блок по определенным координатам

• placeBlock : разместить блок в определенных координатах

Управление запасами

• checkInventory : Базовая проверка инвентаря

• inventoryDetails : Получите подробную информацию о товарах на складе

• equipItem : Экипировать предмет из инвентаря в руку или слот брони.

• tossItem : Выбросить предметы из инвентаря

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

• getNearbyPlayers : Получить список игроков поблизости

• getNearbyEntities : Получить список всех объектов поблизости

• attackEntity : Атака на определенную сущность

• useOnEntity : использовать удерживаемый элемент для определенного объекта

• followEntity : Подписаться на определенную сущность

Взаимодействие с контейнером

• openContainer : Открыть контейнер (сундук, печь и т. д.) в определенных координатах

• withdrawItem : Взять предметы из открытого контейнера

• depositItem : Поместить предметы в открытый контейнер

• closeContainer : Закрыть текущий открытый контейнер.

Крафт

• getRecipes : Получить список доступных рецептов крафта

• craftItem : Изготовить предмет, используя доступные материалы.

Торговля

• listTrades : Список доступных сделок от жителя соседней деревни

• tradeWithVillager : Торговля с ближайшим жителем деревни

Примеры подсказок

Основные элементы управления

• «Подключитесь к серверу Minecraft по адресу play.example.com с именем пользователя player1»

• «Какова моя текущая позиция в игре?»

• «Переместите меня в точку с координатами x=100, y=64, z=-200»

• «Заставьте меня пройти вперед 3 секунды»

• «Заставь меня подпрыгнуть и побежать к той горе»

Инвентарь и предметы

• «Проверьте, что находится в моем инвентаре подробно»

• «Вложи мой алмазный меч в мою руку»

• «Бросьте 5 блоков земли из моего инвентаря»

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

• «Выкопайте блок с координатами x=10, y=65, z=20»

• «Поместите каменный блок в точку с координатами x=11, y=65, z=20»

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

• «Есть ли поблизости другие игроки?»

• «Какие сущности находятся в радиусе 20 кварталов от меня?»

• «Атаковать зомби с ID 12345»

• «Следуйте за игроком по имени Стив»

Использование контейнера

• "Открыть сундук в точке с координатами x=100, y=64, z=200"

• «Возьми 10 железных слитков из сундука»

• «Положи 5 булыжников в сундук»

• «Закройте контейнер»

Ремесло и торговля

• «Какие рецепты для деревянной кирки у меня есть?»

• «Сделай 4 палки, используя древесину в моем инвентаре»

• «Проверьте, какие услуги предлагает житель соседней деревни»

• «Торгуй с жителем деревни, чтобы получить 10 изумрудов»

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

• «Отправить приветственное сообщение в чат»

• «Расскажи всем, что я нашел алмазы»

Требования

• Node.js 18+

• Помощник ИИ, поддерживающий MCP (например, Клод)

• Сервер Minecraft Java Edition (версия 1.8 или более поздняя)

Примечание : этот инструмент был протестирован и проверен на совместимость с vanilla Minecraft 1.21. Хотя он может работать с другими версиями или модифицированными серверами, совместимость не гарантируется.

Лицензия

Массачусетский технологический институт