mc-rp-assistant-mcp

Servidor MCP para el análisis, la validación y la gestión de paquetes de recursos de Minecraft. Lee pack.mcmeta, valida la estructura, lista los recursos, compara paquetes y consulta Modrinth.

Herramientas

Related MCP server: Packwright MCP

Funciones exportadas

• readPackMetaExport(packPath) — Lee pack.mcmeta

• validateRpStructureExport(packPath, mcVersion?) — Valida la estructura del paquete

• listRpAssetsExport(packPath, limit?) — Lista los archivos de recursos

• compareRpacksExport(oldPackPath, newPackPath) — Compara dos paquetes

• searchRpOnModrinthExport(query, limit?) — Busca en Modrinth

• getRpInfoExport(slugOrId) — Obtiene información del paquete de Modrinth

• validateTexturesExport(packPath) — Valida las texturas

• analyzeLangFilesExport(packPath) — Analiza los archivos de idioma

• compareRpacksDiffExport(oldPackPath, newPackPath) — Comparación detallada de paquetes

Uso

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

Desarrollo

npm run build   # Compile TypeScript
npm run test:unit  # Run unit tests
npm test        # Run all tests

Pruebas

npm run build
npm test

Todas las pruebas unitarias son sin conexión, excepto searchRpOnModrinth y getRpInfo, que devuelven resultados vacíos de forma elegante cuando no hay red disponible.

Compatibilidad de plataformas

Todas las herramientas usan las API fs y path de Node.js multiplataforma. El soporte de .zip requiere adm-zip. Las herramientas que dependen de la red (search_rp_on_modrinth, get_rp_info) funcionan en todas las plataformas cuando hay conexión; devuelven resultados vacíos de forma elegante cuando están sin conexión.

Requisitos

• Node.js 18+

• @modelcontextprotocol/sdk, zod, adm-zip

Licencia

MIT