minecraft-mod-mcp-server

MCP-Server auf Cloudflare Workers für die Entwicklung von Minecraft-Modpacks. Generiert FTB-Quests-Kapitel und -Aufgaben, KubeJS-Skripte (Waffen, Rüstungen, Rezepte), validiert SNBT-/Konfigurationsdateien und bietet Diagnoseprüfungen.

Bereitstellung

Dieser MCP läuft auf Cloudflare Workers. Nach der Bereitstellung ist er erreichbar unter:

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

Für die lokale Entwicklung wird wrangler dev verwendet, um vor der Bereitstellung eine Vorschau anzuzeigen.

Tools

FTB-Quests-Generierung

KubeJS-Skript-Generierung

Validierung und Diagnose

Funktionen

• FTB-Quests-Generierung — vollständige SNBT-Ausgabe für Questbücher mit Abhängigkeiten, Belohnungen und Gruppierung

• KubeJS-Skript-Generierung — Waffen, Rüstungen, Form-/Formlos-/Schmelzrezepte und Rezeptentfernungen

• SNBT-Validierung — erkennt Syntaxfehler, bevor sie Laufzeitprobleme im Spiel verursachen

• KubeJS-Diagnose — erkennt veraltete APIs und Rhino-Engine-Kompatibilitätsprobleme

• Keine Netzwerkabhängigkeit — die gesamte Generierung ist rein algorithmisch; es werden keine externen APIs aufgerufen

• Cloudflare-Workers-Bereitstellung — läuft weltweit mit geringer Latenz über das Workers-Edge-Netzwerk

Installation (Lokale Entwicklung)

Voraussetzungen

• Node.js 18+

• npm

• Wrangler-CLI

Einrichtung

cd minecraft-mcp-server
npm install

Lokal ausführen

npm start
# or
npx wrangler dev

Anschließend Verbindung über den MCP-Client zu http://localhost:8788/mcp herstellen.

Auf Cloudflare bereitstellen

npm run deploy

Konfiguration für MCP-Clients

Nach der Bereitstellung zur MCP-Client-Konfiguration hinzufügen:

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

Oder bei Verwendung eines HTTP-basierten MCP-Clients:

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

Ersetzen Sie <your-worker> und <your-subdomain> durch Ihre tatsächliche Cloudflare-Workers-Bereitstellungs-URL.

Architektur

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

Der MCP-Server basiert auf dem @modelcontextprotocol/sdk v1.x und wird als Cloudflare-Worker mithilfe des createLegacyMcpHandler der agents-Bibliothek bereitgestellt.

Tests

npm test
# or
npx vitest run

Alle 49 Unit-Tests laufen vollständig offline — es sind weder Netzwerk noch ein Cloudflare-Konto für die Tests erforderlich.

Plattformkompatibilität

Dieser MCP läuft vollständig auf der Cloudflare-Workers-Infrastruktur. Die einzige Plattformabhängigkeit ist ein Cloudflare-Konto mit aktivierten Workers. Die gesamte Generierungslogik ist reines JavaScript/TypeScript und vollständig plattformübergreifend.

Lizenz

MIT