mc-mod-mcp

MCP-сервер, который дает Claude обоснованные ответы при написании модов для Minecraft.

Он ориентирован на две эпохи моддинга, которые до сих пор актуальны — 1.8.9 (Forge/MCP, Java 8, клиентские моды в стиле Hypixel) и 1.21.10+ (NeoForge или Fabric, Java 21, маппинги Mojang, компоненты данных). Для 1.21.x он также может выполнять поиск маппингов в реальном времени через linkie и получать их напрямую из piston-meta, если linkie еще не добавил свежий релиз.

Без этого инструмента Claude склонен смешивать две эпохи, галлюцинировать new ResourceLocation(...) (удалено с версии 1.20.5), забывать, что предметы теперь используют компоненты данных вместо NBT, и писать ServerboundUseItemPacket без новых полей sequence/yaw/pitch. С ним у модели есть факты для проверки, а не просто названия, которые нужно угадывать.

Установка

git clone https://github.com/ratph6/mc-mod-mcp
cd mc-mod-mcp
npm install
npm run build

Затем укажите Claude Code путь к собранному бинарному файлу:

claude mcp add mc-mod node "$PWD/dist/index.js"

(или отредактируйте ~/.claude/config.json вручную, если предпочитаете).

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

Просто задайте вопрос на обычном английском языке. Claude сам выберет нужный инструмент. Вот несколько примеров, которые задействуют его возможности:

How do I send a useItem packet in 1.21.10 Fabric?
Translate this 1.8.9 snippet to 1.21+: Minecraft.getMinecraft().thePlayer.addChatMessage(new ChatComponentText("hi"))
Scaffold a NeoForge 1.21.10 mod main class for examplemod
Show me a @ModifyVariable mixin example
What's the Yarn name for LocalPlayer in 1.21.10?

Инструменты

имя	что делает
`mc_version_info`	Загрузчики, Java, маппинги, система сборки, ссылки на документацию для эпохи
`mc_lookup_class`	Полное имя класса в 1.8.9 против 1.21+ для концепции (`Block`, `Level`, `BlockEntity`, …)
`mc_lookup_api`	Каноничный сниппет для задачи (`send chat`, `open gui`, `register block`, …)
`mc_translate`	Перевод символа из одной эпохи в эквивалент другой
`mc_event`	"Какое событие срабатывает при X?" — дает ответ для 1.8.9 + NeoForge + Fabric
`mc_mixin`	Каталог паттернов миксинов (`@Inject`, `@ModifyArg`, `@WrapOperation`, `@Accessor`, …) плюс JSON конфигурации миксинов
`mc_gotchas`	Ловушки конкретных эпох — компоненты данных, фабрика ResourceLocation, mod bus против game bus и т.д. С фильтрацией.
`mc_gradle`	`build.gradle` / `settings.gradle` / `gradle.properties` для эпохи + загрузчика
`mc_mappings_translate`	Перевод имен классов Yarn ↔ Mojang (курируемый)
`mc_list_scaffolds`	Перечисление шаблонов каркасов
`mc_scaffold`	Генерация шаблонного кода (основной класс мода, предмет/блок, команда, привязка клавиш, миксин, сетевой пакет, …)
`mc_docs`	Ссылки на документацию для эпохи
`mc_list_versions`	Актуально: все версии, известные linkie, по пространствам имен
`mc_mappings_search`	Актуально: полнотекстовый поиск по API маппингов linkie
`mc_lookup_field`	Актуально: поиск имени поля через linkie (курируемые таблицы не отслеживают поля)
`mc_mojang_mappings`	Получает `client_mappings.txt` от Mojang напрямую через piston-meta. Используется для 26.1.x и любых версий, с которыми linkie не справляется.

Первые двенадцать инструментов курируются вручную — они быстрые, детерминированные и не требуют сети. Последние четыре обращаются к сети по запросу.

Расширение

Знания хранятся в src/knowledge.ts в виде простых данных. Добавьте запись в CLASSES / METHODS / EVENTS / MIXIN_PATTERNS / GOTCHAS / YARN_TO_MOJANG / GRADLE_TEMPLATES, выполните npm test, и готово. Каркасы (scaffolds) — это функции-шаблоны в том же файле, перечисленные через SCAFFOLD_KINDS.

src/
  index.ts          MCP server, tool definitions, stdio transport
  knowledge.ts      Curated data + scaffold templates
  linkie.ts         Live calls to linkie's mappings API
  mojang.ts         Live piston-meta + proguard parser
  smoke.test.ts     node:test smoke tests

Предостережения

Инструмент не поставляет файлы маппингов Mojang/Yarn/Parchment (они весят много МБ) — для получения «сырых» обфусцированных имен используйте инструменты реального времени или linkie. Он не скажет вам, скомпилируется ли ваш конкретный код, а лишь подтвердит, что структура API верна для данной эпохи. Переводы ориентированы на 1.8.9 и 1.21.10; промежуточные версии обычно также применимы, но считайте их приблизительными.

mc-mod-mcp

mc-mod-mcp

Установка

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

Инструменты

Расширение

Предостережения

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API