mc-mod-mcp

Ein MCP-Server, der Claude fundierte Antworten gibt, wenn du Minecraft-Mods schreibst.

Er zielt auf die zwei Ären der Modding-Szene ab, die tatsächlich noch aktiv sind — 1.8.9 (Forge/MCP, Java 8, Client-Mods im Hypixel-Stil) und 1.21.10+ (NeoForge oder Fabric, Java 21, Mojang-Mappings, Data Components). Für 1.21.x kann er außerdem Live-Mapping-Abfragen gegen linkie durchführen und Mappings direkt von piston-meta beziehen, falls linkie noch keine aktuelle Version eingelesen hat.

Ohne dies neigt Claude dazu, die beiden Ären zu vermischen, new ResourceLocation(...) (seit 1.20.5 entfernt) zu halluzinieren, zu vergessen, dass Items Data Components anstelle von NBT verwenden, und ServerboundUseItemPacket ohne die neuen sequence/yaw/pitch-Felder zu schreiben. Damit hat das Modell einen Fakt zum Nachschlagen, anstatt einen Namen zu raten.

Installation

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

Dann verweise Claude Code auf das erstellte Binary:

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

(oder bearbeite ~/.claude/config.json manuell, falls bevorzugt).

Verwendung

Frag einfach in einfachem Englisch. Claude wählt das Tool aus. Einige Beispiele, die es tatsächlich nutzen:

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?

Tools

Name	Was es tut
`mc_version_info`	Loader, Java, Mappings, Build-System, Dokumentations-Links für eine Ära
`mc_lookup_class`	Vollqualifizierter Klassenname in 1.8.9 vs 1.21+ für ein Konzept (`Block`, `Level`, `BlockEntity`, …)
`mc_lookup_api`	Kanonischer Schnipsel für eine Aufgabe (`send chat`, `open gui`, `register block`, …)
`mc_translate`	Schlägt für ein Symbol aus einer Ära das Äquivalent in der anderen vor
`mc_event`	"Welches Event wird bei X ausgelöst?" — liefert 1.8.9 + NeoForge + Fabric
`mc_mixin`	Mixin-Musterkatalog (`@Inject`, `@ModifyArg`, `@WrapOperation`, `@Accessor`, …) plus Mixin-Konfigurations-JSON
`mc_gotchas`	Ära-spezifische Fallstricke — Data Components, ResourceLocation-Factory, Mod-Bus vs. Game-Bus, etc. Filterbar.
`mc_gradle`	`build.gradle` / `settings.gradle` / `gradle.properties` für eine Ära + Loader
`mc_mappings_translate`	Yarn ↔ Mojang Klassenname-Übersetzung (kuratiert)
`mc_list_scaffolds`	Listet Scaffold-Vorlagen auf
`mc_scaffold`	Erzeugt Boilerplate (Mod-Main, Item/Block, Befehl, Key-Binding, Mixin, Netzwerk-Payload, …)
`mc_docs`	Dokumentations-Links für eine Ära
`mc_list_versions`	Live: Jede Version, die linkie kennt, pro Namespace
`mc_mappings_search`	Live: Volltextsuche gegen die Mappings-API von linkie
`mc_lookup_field`	Live: Feldnamen-Suche gegen linkie (die kuratierten Tabellen verfolgen keine Felder)
`mc_mojang_mappings`	Ruft Mojangs `client_mappings.txt` direkt über piston-meta ab. Wird für 26.1.x und jede Version verwendet, bei der linkie scheitert.

Die ersten zwölf sind kuratiert — schnell, deterministisch, kein Netzwerk. Die letzten vier greifen bei Bedarf auf das Netzwerk zu.

Erweitern

Das Wissen liegt in src/knowledge.ts als flache Daten. Füge einen Eintrag zu CLASSES / METHODS / EVENTS / MIXIN_PATTERNS / GOTCHAS / YARN_TO_MOJANG / GRADLE_TEMPLATES hinzu, führe npm test aus, fertig. Scaffolds sind Vorlagenfunktionen in derselben Datei, aufgelistet über 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

Vorbehalte

Es liefert keine Mojang/Yarn/Parchment-Mapping-Dateien mit (mehrere MB) — für rohe obf-Namen verwende die Live-Tools oder linkie. Es sagt dir nicht, ob dein spezifischer Code kompiliert, nur dass die API-Form für die Ära korrekt ist. Übersetzungen zielen auf 1.8.9 und 1.21.10 ab; Zwischenversionen gelten meistens auch, betrachte sie jedoch als annähernd.

mc-mod-mcp

mc-mod-mcp

Installation

Verwendung

Tools

Erweitern

Vorbehalte

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API