MCP Minecraft Remote

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. Хотя он может работать с другими версиями или модифицированными серверами, совместимость не гарантируется.

Лицензия

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