MCP Server mod

🤖 MCP Server Mod

Преобрази свой опыт в Minecraft, подключив ИИ-ассистентов напрямую к игре!

MCP Server Mod реализует стандарт Model Context Protocol (MCP), создавая потоковый HTTP-сервер, который позволяет большим языковым моделям вроде Claude, GPT и другим ИИ-ассистентам взаимодействовать с твоим миром Minecraft через структурированные команды.

✨ Что делает этот мод

Мод запускает потоковый HTTP-сервер на порту 8080, который принимает запросы по протоколу MCP, позволяя ИИ-ассистентам:

• 🏗️ Строить структуры, выполняя команды размещения
• 🔍 Анализировать твой мир, сканируя области блоков
• 📊 Получать информацию об игроке, включая позицию, здоровье и инвентарь

• 🎮 Управлять игровой механикой через безопасное выполнение команд

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

  1. execute_commands — выполнение команд

  Выполняет команды Minecraft с тщательной проверкой безопасности:

• Поддерживаемые команды: fill, setblock, clone, summon, tp, give, gamemode, effect, enchant, weather, time, say
• Ограничения безопасности: предотвращает разрушительные операции вроде массового убийства сущностей или чрезмерного изменения областей

• Отслеживание результата: возвращает подробную информацию об изменениях блоков, спавне сущностей и результатах команд

  2. get_player_info — подробный статус игрока

  Получает детальную информацию об игроке:

• Позиция: точные координаты (x, y, z) и позиции блоков
• Ориентация: направление взгляда, yaw/pitch, сторона света
• Вычисленные позиции: позиция перед игроком для строительства (3 блока вперёд)
• Здоровье и статус: здоровье, уровень еды, опыт
• Состояние игры: текущее измерение, время в мире, игровой режим

• Инвентарь: выбранный слот, предметы в основной и второй руке

  Идеально для: строительства с учётом контекста, команд относительно игрока, отслеживания статуса

  3. get_blocks_in_area — анализ мира

  Сканирует прямоугольные области для анализа структур:

• Определение блоков: возвращает все непустые блоки в указанной области
• Ограничения области: настраиваемый максимальный размер области (по умолчанию: 50x50x50)
• Анализ структур: идеально для понимания существующих построек

• Планирование строительства: проверяй области перед постройкой

  4. take_screenshot — визуальный осмотр

  Делает снимок текущего экрана Minecraft и возвращает его как изображение в ответе MCP.

• Необязательное позиционирование камеры: укажи x, y, z, чтобы телепортироваться перед снимком
• Необязательное управление обзором: укажи yaw, pitch, чтобы задать направление камеры
• Вывод изображения: возвращает Base64 PNG (image/png) для прямого анализа ИИ
• Отлично подходит для проверки построек: визуально проверяй форму структуры, размещение блоков и окружение

• Поддерживается начиная с версии 1.1.1+mc1.21.11

  Важное поведение:

• Если указаны x, y, z, игрок телепортируется.

• Если указаны yaw, pitch, взгляд игрока меняется.

  🚀 Как использовать

  Установка

  1. Установи Fabric Loader 0.16.14+ для Minecraft 1.21.4
  2. Установи Fabric API 0.119.3+1.21.4
  3. Помести этот мод в папку mods
  4. Запусти Minecraft — MCP-сервер запустится автоматически на http://localhost:8080/mcp

  ⚠️ Важно: права на команды

  Перед использованием инструментов команд ИИ ввод команд должен быть разрешён:

• Одиночная игра: при создании мира установи Allow Cheats в положение ON

• Мультиплеер / выделенный сервер: у игрока должно быть разрешение на команды (OP или аналогичное разрешение сервера)

  ⚠️ Важно: отключи "Pause on Lost Focus"

  КРИТИЧЕСКИ ВАЖНЫЙ ШАГ: нужно отключить настройку Minecraft "Pause on Lost Focus", чтобы ИИ мог взаимодействовать при переключении между приложениями:

• Нажми F3 + P в игре, чтобы отключить "Pause on Lost Focus"
• Появится сообщение, подтверждающее изменение настройки

Без этого изменения игра будет ставиться на паузу каждый раз, когда вы переключаетесь на свой ИИ-редактор, из-за чего команды не смогут выполняться корректно.

Подключение ИИ-редакторов кода (прямая поддержка)

Cursor IDE

1. Добавьте конфигурацию MCP-сервера в настройках Cursor
2. Используйте HTTP-транспорт: http://localhost:8080/mcp
3. Начните писать код с ИИ-помощником, который умеет управлять Minecraft!

{
  "mcpServers": {
    "minecraft": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Windsurf IDE

1. Настройте MCP-подключение в Windsurf
2. Подключитесь к: http://localhost:8080/mcp

3. Включите взаимодействие с Minecraft через ИИ

   VS Code с расширениями

   • GitHub Copilot: настройте интеграцию MCP
   • Roo Code: прямая поддержка HTTP MCP
   • Другие MCP-расширения: совместимы с потоковым HTTP-транспортом

   Подключение других ИИ-ассистентов

   Claude Code

   Поскольку Claude Code использует stdio-транспорт, вам понадобится прокси:

4. Установите mcp-proxy или аналогичный мост stdio-to-HTTP
5. Настройте прокси для преобразования stdio ↔ потоковый HTTP

6. Подключите Claude Code к прокси

   Примеры взаимодействия с ИИ

   "Построй мне маленький дом" → ИИ использует get_player_info, чтобы найти ваше местоположение, затем execute_commands для установки блоков

   "Какие блоки вокруг меня?"→ ИИ использует get_blocks_in_area для сканирования ближайших областей и сообщает результаты

   "Очисти эту область и построй ферму" → ИИ объединяет несколько инструментов, чтобы проанализировать, очистить и построить

   🔧 Технические детали

   • Потоковый HTTP-транспорт: полная поддержка протокола MCP по HTTP
   • Клиентский мод: работает полностью на стороне клиента Minecraft
   • Соответствие стандартам: реализует официальную спецификацию Model Context Protocol
   • Сжатие блоков: автоматически оптимизирует представление изменений блоков
   • Захват чата: отслеживает вывод команд и ответы игры
   • Раздельная среда: использует разделение исходников client/main в Fabric
   • Подробное логирование: детальные логи операций для отладки

   🆘 Решение проблем

   Сервер не запускается?

   • Проверьте, свободен ли порт 8080
   • Убедитесь, что установлен Fabric API
   • Проверьте логи на ошибки конфигурации

   ИИ не может подключиться?

   • Убедитесь, что брандмауэр разрешает localhost:8080
   • Проверьте, поддерживает ли MCP-клиент HTTP-транспорт
   • Для stdio-клиентов используйте мост mcp-proxy

   Команды не работают?

   • Убедитесь, что у вас есть соответствующие права
   • Проверьте, что "Pause on Lost Focus" отключено (F3+P)
   • Проверьте синтаксис и лимиты команд

   Игра постоянно ставится на паузу?

   • Убедитесь, что "Pause on Lost Focus" ВЫКЛЮЧЕНО (F3+P)
   • Это необходимо для взаимодействия с ИИ при многозадачности

   🔗 Ссылки

   • Исходный код: https://github.com/cuspymd/mcp-server-mod
   • Трекер задач: https://github.com/cuspymd/mcp-server-mod/issues
   • Спецификация MCP: https://modelcontextprotocol.io
   • Документация Fabric: https://fabricmc.net/wiki/