mc-pack-builder-mcp

Servidor MCP para la construcción de modpacks de Minecraft. Crea estructuras de paquetes, busca mods en Modrinth, resuelve dependencias y comprueba la compatibilidad.

Herramientas

Related MCP server: HMCL MCP Server

Características

• Creación de estructura de paquete — genera un directorio estándar de modpack con todos los archivos necesarios

• Integración con Modrinth — busca y consulta metadatos de mods directamente desde la API de Modrinth

• Resolución de dependencias — sigue el árbol completo de dependencias para asegurar que se cumplan todos los requisitos

• Comprobación de compatibilidad — detecta conflictos conocidos (p. ej., OptiFine con Fabric, Sodium vs Embeddium)

• Operación sin conexión — todas las herramientas locales de paquete funcionan sin red; solo las herramientas de búsqueda/información necesitan Modrinth

Instalación

Requisitos previos

• Node.js 18+

• npm

Compilación

cd mc-pack-builder-mcp
npm install
npm run build

Ejecutar como servidor MCP independiente

node dist/index.js

El servidor se comunica a través de stdio (JSON-RPC 2.0). Puede ser consumido por cualquier cliente compatible con MCP.

Configuración para clientes MCP

Añade a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "mc-pack-builder": {
      "command": "node",
      "args": ["<path/to/mc-pack-builder-mcp>/dist/index.js"]
    }
  }
}

Ejemplos de uso

Crear un nuevo modpack

{
  "name": "create_pack",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",
    "name": "My Modpack",
    "mc_version": "1.20.1",
    "loader": "fabric"
  }
}

Buscar un mod en Modrinth

{
  "name": "search_mods",
  "arguments": {
    "query": "sodium",
    "limit": 5
  }
}

Resolver dependencias

{
  "name": "resolve_dependencies",
  "arguments": {
    "project_id": "geckolib"
  }
}

Comprobar la compatibilidad del paquete

{
  "name": "check_pack_compatibility",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",
    "mc_version": "1.20.1"
  }
}

Arquitectura

mc-pack-builder-mcp/
├── src/
│   └── index.ts        # MCP server + all tool implementations
├── dist/               # Compiled JavaScript (output of tsc)
├── __tests__/
│   └── unit.test.ts    # Unit tests (offline)
├── package.json        # Node.js dependencies (@modelcontextprotocol/sdk, zod)
├── tsconfig.json       # TypeScript config (CommonJS output)
├── test.js             # Integration test runner
├── test_logs/          # Test output logs (gitignored)
└── .gitignore

El MCP utiliza el @modelcontextprotocol/sdk oficial v1.x con McpServer y StdioServerTransport.

Pruebas

npm run build
node test.js

Las pruebas crean directorios temporales bajo os.tmpdir() y se limpian solas. No se requiere instalación de Minecraft.

Compatibilidad de plataformas

Todas las herramientas utilizan las APIs fs y path de Node.js multiplataforma. Las herramientas que dependen de la red (search_mods, get_mod_info, resolve_dependencies) requieren acceso a internet independientemente de la plataforma.

Licencia

MIT