minecraft-mod-mcp-server

Servidor MCP en Cloudflare Workers para el desarrollo de modpacks de Minecraft. Genera capítulos y tareas de FTB Quests, scripts de KubeJS (armas, armaduras, recetas), valida archivos SNBT/config y proporciona comprobaciones de diagnóstico.

Despliegue

Este MCP se ejecuta en Cloudflare Workers. Tras el despliegue, es accesible en:

https://<your-worker>.<your-subdomain>.workers.dev/mcp

El desarrollo local usa wrangler dev para previsualizar antes de desplegar.

Herramientas

Generación de FTB Quests

Generación de scripts de KubeJS

Validación y diagnóstico

Características

• Generación de FTB Quests — salida SNBT completa para libros de misiones con dependencias, recompensas y agrupación

• Generación de scripts de KubeJS — armas, armaduras, recetas con forma/sin forma/fundición y eliminación de recetas

• Validación SNBT — detecta errores de sintaxis antes de que causen problemas en tiempo de ejecución en el juego

• Diagnóstico de KubeJS — detecta APIs obsoletas y problemas de compatibilidad con el motor Rhino

• Sin dependencias de red — toda la generación es puramente algorítmica; no se llama a APIs externas

• Despliegue en Cloudflare Workers — se ejecuta globalmente con baja latencia mediante la red perimetral de Workers

Instalación (desarrollo local)

Requisitos previos

• Node.js 18+

• npm

• CLI de Wrangler

Configuración

cd minecraft-mcp-server
npm install

Ejecutar localmente

npm start
# or
npx wrangler dev

Luego conéctate al cliente MCP en http://localhost:8788/mcp.

Desplegar en Cloudflare

npm run deploy

Configuración para clientes MCP

Tras el despliegue, añade a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "minecraft-mod": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-stdio"],
      "env": {
        "MCP_SERVER_URL": "https://<your-worker>.<your-subdomain>.workers.dev/mcp"
      }
    }
  }
}

O si usas un cliente MCP basado en HTTP:

{
  "mcpServers": {
    "minecraft-mod": {
      "url": "https://<your-worker>.<your-subdomain>.workers.dev/mcp"
    }
  }
}

Reemplaza <your-worker> y <your-subdomain> con la URL de despliegue real de tu worker.

Arquitectura

minecraft-mcp-server/
├── src/
│   ├── index.ts           # Cloudflare Worker entry point + MCP server setup
│   ├── types.ts           # Cloudflare Workers environment types
│   ├── tools/
│   │   ├── quest.ts       # FTB Quests generation logic
│   │   ├── kubejs.ts      # KubeJS script generation logic
│   │   └── validate.ts    # SNBT validation + KubeJS diagnostics
│   └── templates/
│       ├── quest_chapter.ts
│       ├── kubejs_item.ts
│       └── kubejs_recipe.ts
├── __tests__/
│   └── unit.test.ts       # Unit tests (fully offline, 49 tests)
├── vitest.config.ts       # Vitest config (ESM, globals: false)
├── package.json           # Dependencies (@modelcontextprotocol/sdk, agents, zod, wrangler)
└── wrangler.jsonc         # Cloudflare Workers deployment config

El servidor MCP se basa en @modelcontextprotocol/sdk v1.x y se despliega como un Cloudflare Worker usando la función createLegacyMcpHandler de la librería agents.

Pruebas

npm test
# or
npx vitest run

Las 49 pruebas funcionan completamente sin conexión — no se necesita red ni cuenta de Cloudflare para las pruebas.

Compatibilidad de plataformas

Este MCP se ejecuta enteramente en la infraestructura de Cloudflare Workers. La única dependencia de plataforma es tener una cuenta de Cloudflare con Workers habilitado. Toda la lógica de generación es JavaScript/TypeScript puro y es totalmente multiplataforma.

Licencia

MIT