mc-mod-mcp

Un servidor MCP que ofrece a Claude respuestas fundamentadas cuando escribes mods de Minecraft.

Se centra en las dos eras de la escena de modding que siguen activas: 1.8.9 (Forge/MCP, Java 8, mods de cliente estilo Hypixel) y 1.21.10+ (NeoForge o Fabric, Java 21, mapeos de Mojang, Data Components). Para la 1.21.x, también puede realizar búsquedas de mapeo en tiempo real contra linkie y extraer mapeos directamente de piston-meta cuando linkie aún no ha procesado una versión reciente.

Sin esto, Claude tiende a mezclar ambas eras, alucinar new ResourceLocation(...) (desaparecido desde la 1.20.5), olvidar que los objetos usan Data Components en lugar de NBT, y escribir ServerboundUseItemPacket sin los nuevos campos de secuencia/yaw/pitch. Con esto, el modelo tiene un hecho que consultar en lugar de un nombre que adivinar.

Instalación

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

Luego, apunta Claude Code al binario compilado:

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

(o edita manualmente ~/.claude/config.json si lo prefieres).

Uso

Simplemente pregunta en lenguaje sencillo. Claude elegirá la herramienta. Algunos ejemplos que realmente la ponen a prueba:

¿Cómo envío un paquete useItem en Fabric 1.21.10?
Traduce este fragmento de 1.8.9 a 1.21+: Minecraft.getMinecraft().thePlayer.addChatMessage(new ChatComponentText("hi"))
Crea la estructura de una clase principal de mod NeoForge 1.21.10 para examplemod
Muéstrame un ejemplo de mixin @ModifyVariable
¿Cuál es el nombre en Yarn para LocalPlayer en 1.21.10?

Herramientas

nombre	qué hace
`mc_version_info`	Cargadores, Java, mapeos, sistema de compilación, enlaces de documentación para una era
`mc_lookup_class`	Nombre de clase totalmente calificado en 1.8.9 vs 1.21+ para un concepto (`Block`, `Level`, `BlockEntity`, …)
`mc_lookup_api`	Fragmento canónico para una tarea (`enviar chat`, `abrir gui`, `registrar bloque`, …)
`mc_translate`	Dado un símbolo de una era, sugiere el equivalente en la otra
`mc_event`	"¿Qué evento se dispara cuando X?" — ofrece 1.8.9 + NeoForge + Fabric
`mc_mixin`	Catálogo de patrones de Mixin (`@Inject`, `@ModifyArg`, `@WrapOperation`, `@Accessor`, …) más JSON de configuración de mixin
`mc_gotchas`	Trampas específicas de la era — Data Components, fábrica de ResourceLocation, bus de mod vs bus de juego, etc. Filtrable.
`mc_gradle`	`build.gradle` / `settings.gradle` / `gradle.properties` para una era + cargador
`mc_mappings_translate`	Traducción de nombres de clase Yarn ↔ Mojang (seleccionada)
`mc_list_scaffolds`	Enumera plantillas de estructura
`mc_scaffold`	Emite código base (mod main, item/block, comando, key binding, mixin, payload de red, …)
`mc_docs`	Enlaces de documentación para una era
`mc_list_versions`	En tiempo real: cada versión que conoce linkie, por espacio de nombres
`mc_mappings_search`	En tiempo real: búsqueda de texto completo contra la API de mapeos de linkie
`mc_lookup_field`	En tiempo real: búsqueda de nombre de campo contra linkie (las tablas seleccionadas no rastrean campos)
`mc_mojang_mappings`	Extrae `client_mappings.txt` de Mojang directamente vía piston-meta. Usado para 26.1.x y cualquier versión que falle en linkie.

Las primeras doce están seleccionadas: rápidas, deterministas, sin red. Las últimas cuatro acceden a la red bajo demanda.

Extensión

El conocimiento reside en src/knowledge.ts como datos planos. Añade una entrada a CLASSES / METHODS / EVENTS / MIXIN_PATTERNS / GOTCHAS / YARN_TO_MOJANG / GRADLE_TEMPLATES, ejecuta npm test, y listo. Las estructuras (scaffolds) son funciones de plantilla en el mismo archivo, listadas a través de 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

Advertencias

No incluye archivos de mapeo de Mojang/Yarn/Parchment (de varios MB) — para nombres obf crudos usa las herramientas en tiempo real o linkie. No te dirá si tu código específico compila, solo que la forma de la API es correcta para la era. Las traducciones apuntan a 1.8.9 y 1.21.10; las versiones intermedias suelen aplicar, pero trátalas como aproximaciones.

mc-mod-mcp

mc-mod-mcp

Instalación

Uso

Herramientas

Extensión

Advertencias

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API