MC AI Coding Assistant Tool MCP
MC-AI-Coding-Assistant-Tool
Локальный MCP-сервер для модов Minecraft: правила загрузчиков, документация, маппинги, разбор крашей и проверка прямо в игре.
- 138 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер пишет файлы проекта и конфигурацию хоста, запускает Gradle и саму игру.
- Перед записью конфигурации агент показывает дифф и ждет подтверждения.
Установка
- Работает в
Ручная установка
cd mcp-server && npm ci && npm run buildВыполняется в клонированном репозитории; конфигурацию хоста агент генерирует по `AUTO_SETUP.md` и показывает дифф до записи.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер пишет файлы проекта и конфигурацию хоста, запускает Gradle и саму игру.
- Перед записью конфигурации агент показывает дифф и ждет подтверждения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MC AI Coding Assistant Tool — локальный MCP-сервер по stdio с 89 инструментами для разработки модов Minecraft. Он знает правила Forge, Fabric, NeoForge, Quilt, LiteLoader, Rift, ModLoader, Bedrock Add-On и серверных плагинов Paper и Spigot, ищет по официальной документации нужной версии и переводит имена между шестью системами маппингов. Сервер собирает скелеты проектов, диагностирует Gradle, разбирает отчеты о крэшах, декомпилирует исходники игры и JAR-файлы модов, анализирует перенос мода между загрузчиками и ведет игровую самопроверку со скриншотами и `qa.log`. В репозитории лежат правила и API-сводки для 48 библиотечных модов.
Для кого. Разработчикам модов и сборок Minecraft, которые пишут код с Cursor или Claude Code и страдают от устаревших версий API и путаницы в маппингах.
Подходит, если
- Агент выдумывает методы API, которых нет в вашей версии Forge или Fabric.
- Отчет о крэше нужно разобрать и найти вероятную причину.
- Мод есть только на Forge, а игра идет на Fabric: сначала нужен анализ пути переноса.
- Новый проект собирают из скелета с правилами нужной платформы и версии.
- Изменение проверяют в самой игре со скриншотами и логом.
Не подходит, если
- Работа идет вне Minecraft: сервер знает только моддинг и серверные плагины игры.
- Проект коммерческий: код распространяется по лицензии PolyForm Noncommercial.
- Стоит Node.js старее 22.5.
Пример запроса к агенту
Определи платформу и точную версию моего мода, загрузи пакет правил и объясни, как зарегистрировать новый блок.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
MC_SKILL_DATA- Корень офлайн-данных документации и маппингов.
MC_SKILL_CACHE- Каталог кеша для декомпилированных исходников.
Ограничения
Нужен Node.js 22.5 или новее. На версиях 22.5–22.12 и 23.0–23.3 сервер запускают с флагом `--experimental-sqlite`, иначе он завершится с ошибкой. Код распространяется по PolyForm Noncommercial 1.0.0 с условиями копилефта, коммерческое использование запрещено. Проверка с драйвером внутри игры работает на Minecraft 1.20.1 и новее для Fabric, Quilt, Forge и NeoForge. Конфигурацию хоста агент пишет только после подтверждения диффа.
Как отключить. Удалите запись сервера `MC-AI-Coding-Assistant-Tool` из конфигурации MCP вашего агента и перезагрузите его. Клонированный каталог можно стереть вместе с кешем из `MC_SKILL_CACHE`.
Частые вопросы
Как установить MCP-сервер для модов Minecraft?
Попросите агента поставить репозиторий. Он определит хост, соберет сервер командой `npm ci && npm run build` в `mcp-server`, покажет дифф файла конфигурации и запишет его после вашего подтверждения. После перезагрузки хоста вызовите `get_server_status`.
Работает ли сервер без подключения MCP?
Да. Если инструменты не видны или перезагружать хост не хочется, агент может вызывать CLI: `node mcp-server/dist/cli.js`, например с `activate_platform_pack --action=list`.
Какие платформы поддерживаются?
Forge, Fabric, NeoForge, Quilt, LiteLoader, Rift, ModLoader, Bedrock Add-On и серверы Paper и Spigot. Основные версии: Forge 1.20.1, Fabric 1.20.1, 1.21.x, 26.1.2 и 26.2.
Как сервер защищает от путаницы версий?
Агент определяет платформу и точную версию по `AGENTS.md`, затем грузит пакет правил командой `activate_platform_pack action=session`. Соседние версии вместо нужной не подставляются.
Можно ли использовать сервер в коммерческом проекте?
Нет. Код распространяется по PolyForm Noncommercial 1.0.0 с копилефтом: нужна атрибуция, производные работы открывают под той же лицензией.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
13 скиллов для Codex и Claude Code ведут моддинг, плагины, датапаки, ресурспаки и администрирование серверов Minecraft.
Cocos Creator MCP Server
Cocos Creator MCP Server Plugin
MCP-сервер как расширение редактора Cocos Creator: агент управляет сценами, нодами, компонентами, префабами и ресурсами проекта
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
MCP-сервер ищет определения и смысловые фрагменты кода по локальному индексу, объединяя векторы и полнотекстовый поиск.
MCP и CLI для SourceCraft: репозитории и CI/CD
SourceCraft MCP Server
MCP-сервер, CLI-утилита и скилл для платформы разработки SourceCraft от Яндекса: репозитории, issues, pull requests, CI/CD и релизы, 48 инструментов
Коротко о README
Репозиторий разделен на папки загрузчиков с правилами и скиллами, офлайн-данные документации и маппингов, базу знаний сообщества и сам сервер в `mcp-server`. Проверка идет по ступеням: от сборки и статического анализа до игровой проверки и тестов с несколькими клиентами.