mc-pack-builder-mcp

MCP-Server für den Bau von Minecraft-Modpacks. Erstellt Pack-Strukturen, sucht Mods auf Modrinth, löst Abhängigkeiten auf und prüft Kompatibilität.

Tools

Related MCP server: HMCL MCP Server

Funktionen

• Erstellung der Pack-Struktur — erzeugt ein Standard-Modpack-Verzeichnis mit allen erforderlichen Dateien

• Modrinth-Integration — sucht und fragt Mod-Metadaten direkt über die Modrinth-API ab

• Abhängigkeitsauflösung — verfolgt den vollständigen Abhängigkeitsbaum, um sicherzustellen, dass alle Anforderungen erfüllt sind

• Kompatibilitätsprüfung — erkennt bekannte Konflikte (z. B. OptiFine mit Fabric, Sodium vs. Embeddium)

• Offline-Betrieb — alle lokalen Pack-Tools funktionieren ohne Netzwerk; nur Such-/Info-Tools benötigen Modrinth

Installation

Voraussetzungen

• Node.js 18+

• npm

Build

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

Als eigenständigen MCP-Server ausführen

node dist/index.js

Der Server kommuniziert über stdio (JSON-RPC 2.0). Er kann von jedem MCP-kompatiblen Client verwendet werden.

Konfiguration für MCP-Clients

Fügen Sie Folgendes zu Ihrer MCP-Client-Konfiguration hinzu:

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

Verwendungsbeispiele

Ein neues Modpack erstellen

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

Nach einer Mod auf Modrinth suchen

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

Abhängigkeiten auflösen

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

Pack-Kompatibilität prüfen

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

Architektur

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

Der MCP verwendet das offizielle @modelcontextprotocol/sdk v1.x mit McpServer und StdioServerTransport.

Tests

npm run build
node test.js

Tests erstellen temporäre Verzeichnisse unter os.tmpdir() und räumen danach selbst auf. Keine Minecraft-Installation ist erforderlich.

Plattform-Kompatibilität

Alle Tools verwenden plattformübergreifende Node.js-fs- und path-APIs. Netzwerkabhängige Tools (search_mods, get_mod_info, resolve_dependencies) benötigen unabhängig von der Plattform Internetzugriff.

Lizenz

MIT