mc-rp-assistant-mcp

MCP-Server für die Analyse, Validierung und Verwaltung von Minecraft-Ressourcenpaketen. Liest pack.mcmeta, validiert die Struktur, listet Assets auf, vergleicht Pakete und fragt Modrinth ab.

Werkzeuge

Related MCP server: Packwright MCP

Exportierte Funktionen

• readPackMetaExport(packPath) — pack.mcmeta lesen

• validateRpStructureExport(packPath, mcVersion?) — Paketstruktur validieren

• listRpAssetsExport(packPath, limit?) — Asset-Dateien auflisten

• compareRpacksExport(oldPackPath, newPackPath) — Zwei Pakete vergleichen

• searchRpOnModrinthExport(query, limit?) — Modrinth durchsuchen

• getRpInfoExport(slugOrId) — Paketinformationen von Modrinth abrufen

• validateTexturesExport(packPath) — Texturen validieren

• analyzeLangFilesExport(packPath) — Sprachdateien analysieren

• compareRpacksDiffExport(oldPackPath, newPackPath) — Detaillierter Paketvergleich

Verwendung

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

Entwicklung

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

Testen

npm run build
npm test

Alle Unit-Tests laufen offline, außer searchRpOnModrinth und getRpInfo, die bei fehlender Netzwerkverbindung ordnungsgemäß leere Ergebnisse zurückgeben.

Plattformkompatibilität

Alle Werkzeuge verwenden plattformübergreifende Node.js-fs- und path-APIs. .zip-Unterstützung erfordert adm-zip. Netzwerkabhängige Werkzeuge (search_rp_on_modrinth, get_rp_info) funktionieren auf allen Plattformen, wenn sie online sind; sie geben ordnungsgemäß leere Ergebnisse zurück, wenn sie offline sind.

Anforderungen

• Node.js 18+

• @modelcontextprotocol/sdk, zod, adm-zip

Lizenz

MIT