DeveloperMCP — ИИ-помощник для Minecraft сервера
Представьте, что у вас есть старший разработчик, который сидит прямо в консоли вашего Minecraft сервера и мгновенно выполняет любые команды. Именно это делает DeveloperMCP — уникальное дополнение, превращающее обычный сервер Spigot или Paper в площадку для прямого взаимодействия с искусственным интеллектом. Больше не нужно переключаться между FTP-клиентом, редактором конфигов и окном чата: ИИ получает контекстный доступ к файлам, логам и консоли, чтобы решать задачи за секунды.
Что такое DeveloperMCP и зачем он нужен
DeveloperMCP (Minecraft Developer MCP) — это плагин, который открывает ваш сервер для MCP-совместимых ИИ-клиентов, таких как Claude или Cursor. Он работает на серверах Spigot и Paper, поддерживая актуальные версии Minecraft 1.20, 1.21 и более новые. Суть проста: вы даёте ИИ безопасный доступ к инструментам сервера, и он может читать конфигурации, выполнять команды, анализировать логи и даже писать код — всё в реальном времени, без необходимости скачивать или загружать файлы вручную.
Основные инструменты и примеры использования
Плагин предоставляет набор мощных инструментов, каждый из которых решает конкретную задачу администрирования. Вот что вы получаете:
- execute_command — выполнение любой консольной команды с полным захватом вывода. Работает со всеми плагинами, включая LuckPerms. Например: «Выдай игроку Notch алмазный меч с именем Excalibur».
- read_file — чтение текстовых файлов (конфиги, логи, данные) прямо из директории сервера. Пример: «Прочитай plugins/Essentials/config.yml и покажи формат чата».
- write_file — создание или редактирование файлов. Идеально для правки конфигураций. «Создай скрипт welcome.sk, который приветствует игроков».
- list_plugins — получение списка всех установленных плагинов с версиями. «Проверь, установлен ли WorldGuard и актуальна ли версия».
- get_logs — извлечение последних 100 строк latest.log. «Почему сервер лагает? Посмотри логи».
- write_file_base64 / read_file_base64 — загрузка и скачивание бинарных файлов (JAR, изображения) через base64. «Загрузи новый SuperSword.jar в папку плагинов» или «Получи иконку сервера world/icon.png для анализа».
- list_directory — просмотр содержимого папок с размерами файлов. «Покажи все файлы в world/region».
Эти инструменты покрывают 90% рутинных операций. Больше не нужно вручную искать ошибку в YAML-конфиге: ИИ сам прочитает файл, найдёт проблемную строку и исправит отступы. Хотите изменить лимит спавна монстров? Просто попросите ИИ прочитать bukkit.yml и обновить значение. Только что установили Essentials? ИИ мгновенно сгенерирует kit.yml с нужными предметами.
Как установить DeveloperMCP
Установка плагина не сложнее, чем добавление любого другого дополнения. Для начала скачайте DeveloperMCP с официальной страницы релизов — вам нужен JAR-файл, совместимый с вашей версией сервера. Поместите его в папку plugins/ и перезапустите сервер, чтобы сгенерировался конфигурационный файл.
Затем откройте plugins/MCPMinecraft/config.yml и настройте два ключевых параметра: порт (например, 25374) и токен. Токен — это ваш главный ключ безопасности, поэтому придумайте длинную случайную строку. Никогда не используйте простые пароли: любой, кто узнает токен, получит доступ к консоли сервера.
Кстати, если вы пользуетесь лаунчером foxygame.net, установка DeveloperMCP становится ещё проще — встроенный каталог дополнений позволяет найти плагин и активировать его в один клик, автоматически подбирая совместимую версию под вашу сборку.
Подключение ИИ-клиента
После настройки серверной части нужно связать её с ИИ. Рассмотрим пример для Cursor. Добавьте в файл mcp.json (обычно находится в ~/.cursor/mcp.json) следующую конфигурацию:
{
"mcpServers": {
"minecraft": {
"url": "http://ВАШ_IP:25374/sse?token=ВАШ_ТОКЕН",
"transport": "sse"
}
}
}Если вы предпочитаете прямые API-запросы для скриптов, можно использовать синхронный эндпоинт /api. Например, curl-запрос для получения списка плагинов:
curl -X POST "http://ВАШ_IP:25374/api?token=ВАШ_ТОКЕН" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_plugins","arguments":{}}}'После перезагрузки ИИ-клиента вы сможете общаться с сервером на естественном языке. Попробуйте сказать: «Создай резервную копию whitelist.json и добавь игрока jeb_ в белый список» или «В конфиге LuckPerms ошибка YAML, прочитай файл и исправь отступы».
Что делать, если хостинг не разрешает дополнительные порты
Многие бесплатные хостинги (например, Aternos) блокируют открытие кастомных портов. Решение есть — используйте туннель playit.gg. Установите плагин playit.gg на сервер, создайте в его панели управления новый Custom TCP Tunnel, направленный на 127.0.0.1:25374 (или тот порт, что указан в конфиге). Playit выдаст публичный адрес вида agent-tunnel.playit.gg:12345, который вы и укажете в mcp.json вместо прямого IP. Туннель работает стабильно и не требует дополнительных настроек роутера.
Почему DeveloperMCP меняет правила игры
Традиционный подход к управлению сервером — это копирование логов, ручная правка YAML, переключение между окнами. Когда вы вставляете фрагмент лога в ChatGPT, он не знает контекста: какие плагины установлены, какие версии, какие значения в других конфигах. DeveloperMCP даёт ИИ возможность «осмотреться» на сервере, проверить зависимости и принять взвешенное решение. Это как иметь администратора, который всегда на связи и понимает инфраструктуру целиком.
Плагин особенно полезен для владельцев серверов