MC-World-MCP

Offline-only MCP-Tools für die Arbeit mit einem Minecraft-Serververzeichnis.

Dieses MCP verwendet absichtlich kein RCON, keine Sockets, keine Online-Spielerabfragen und keine Server-Start-/Stopp-Steuerungen. Es liest und schreibt lediglich lokale Dateien wie level.dat, Datapacks, Strukturvorlagen, Protokolle und Anvil-Regionsdateien.

Der vollständige Schreibpfad zielt auf Java Edition / Arclight 1.20.1-Welten mit DataVersion 3465 ab. Andere Java-Anvil-Welten werden erkannt und für Lesezugriffe nach bestem Bemühen bereitgestellt, aber Schreibvorgänge in die Welt werden abgelehnt, es sei denn, der Versionsadapter markiert sie als vollständig unterstützt. Bedrock-LevelDB-Welten werden als nicht unterstützt erkannt.

Ausführung

Wenn sich dieses Projekt unter E:/VC/mc-world-mcp befindet und sich ein Server-Arbeitsbereich zwei Ebenen unter E:/VC befindet, startet der Arbeitsbereich .vscode/mcp.json den Server mit:

{
  "command": "python",
  "args": ["-m", "mc_world_mcp.server"],
  "env": {
    "PYTHONPATH": "${workspaceFolder}/../../mc-world-mcp/src",
    "MC_SERVER_ROOT": "${workspaceFolder}"
  }
}

MC_SERVER_ROOT sollte auf das Arclight-Server-Stammverzeichnis zeigen, das server.properties und world/ enthält. Wenn dies weggelassen wird, versucht der Server zuerst das aktuelle Arbeitsverzeichnis.

Die Welt-Auswahl folgt dem level-name in server.properties, sodass ein Server, der level-name=world_regen_source verwendet, über dieses Verzeichnis betrieben wird, anstatt über ein hartcodiertes world/. Setzen Sie MC_WORLD_NAME, um dies explizit zu überschreiben.

Related MCP server: ellmos-filecommander-mcp

Sicherheit

Alle Schreib-Tools:

• lehnen Pfade außerhalb von MC_SERVER_ROOT ab

• lehnen Schreibvorgänge ab, wenn ein java- oder javaw-Prozess läuft

• lehnen Schreibvorgänge in Java-Welten ab, es sei denn, die ausgewählte Welt hat die DataVersion 3465

• sichern jede geänderte Datei unter backup/mc_world_mcp/<timestamp>/

• schreiben eine manifest.json, die die geänderten Dateien beschreibt

Lese-Tools sind erlaubt, während der Server läuft.

Tool-Gruppen

• Server/Dateien: Zusammenfassungen, sicheres Lesen/Schreiben von Dateien, Protokolle, Versions-/Plattformerkennung

• NBT: level.dat, Spielerdaten, Weltdaten, Struktur-NBT

• Datapacks: Auflistung von Ordner- und Zip-Datapacks, Validierung, Suche, Lesen, Schreiben

• Regionen: Scannen, Chunks untersuchen, Blöcke abrufen/lesen/setzen/füllen/ersetzen, Blockzustands-Strings

• Weltdiagnose: Dimensionen, Weltabdeckung, Chunk-Paletten, Gruppierung von Protokollproblemen

• Weltdaten: Block-Entitäten, externe Entitätsregionen, POI-Regionen, Biom-Boxen, Löschen von Höhenkarten, Chunk-Bereinigung

• Vorlagen: .nbt-Strukturvorlagen auflisten/lesen/schreiben, Blöcke mit Block-Entitäten und Entitäten nach bestem Bemühen exportieren/platzieren

• Sicherheit: Offline-Prüfungen, Backup-Auflistung, Backup-Wiederherstellung