Minecraft-Befehlsausführungs-MCP-Server

Ein MCP-Server (Model Context Protocol), der es Claude ermöglicht, Minecraft-Befehle auszuführen und Tab-Vervollständigungen über die MasterControl-API zu erhalten.

Funktionen

Dieser MCP-Server stellt zwei Tools bereit:

1. execute_command

Führt jeden Minecraft-Befehl remote als authentifizierter Spieler aus.

• Der Spieler muss online sein und sich auf einem Server befinden

• Der Spieler erhält eine In-Game-Benachrichtigung, wenn Befehle ausgeführt werden

• Gibt die Befehlsausgabe oder Fehlermeldungen zurück

• Um Hilfe zu erhalten: Hängen Sie "help" an jeden Befehl an (z. B. "island help", "island upgrade help")

Beispiele:

execute_command("gamemode creative")
execute_command("island help")              # Shows island command help
execute_command("island upgrade help")      # Shows upgrade subcommand help
execute_command("island upgrade speed 5")

2. tab_complete

Ruft Tab-Vervollständigungsvorschläge für unvollständige Befehle ab.

• Verfügbare Befehle und Unterbefehle entdecken

• Gültige Argumente und Parameter finden

• Funktioniert genau wie das Drücken der Tab-Taste in Minecraft

Beispiele:

tab_complete("gamemode ")   # Returns: survival, creative, adventure, spectator
tab_complete("island ")     # Returns: available island subcommands

Related MCP server: MCP Minecraft Remote

Voraussetzungen

• Python 3.10 oder höher

• uv Paketmanager (hier installieren)

• Ein laufender MasterControl-Server mit der Befehls-API

• Gültiger API-Schlüssel für Ihren Minecraft-Spieler

Installation

1. Repo klonen:

git clone https://github.com/<your-user>/minecraft-mcp-server.git
cd minecraft-mcp-server

2. Abhängigkeiten installieren:

uv sync

3. Umgebungsvariablen konfigurieren:

cp .env.example .env

4. .env mit Ihren Einstellungen bearbeiten:

# Required: Your Midnight API key
MIDNIGHT_API_KEY=your-api-key-here

# Optional: MasterControl API URL (defaults to localhost:8080)
MIDNIGHT_API_URL=http://your-server:8080/api/v2

Verwendung

Lokal testen

Starten Sie den Server direkt zum Testen:

uv run server.py

Er wartet auf stdio-Eingaben – das ist für einen MCP-Server zu erwarten. Strg+C zum Beenden.

Integration mit Claude Code

Fügen Sie den Server zu Claude Code hinzu (verwenden Sie den absoluten Pfad zu Ihrem geklonten Repo):

claude mcp add midnight \
  --transport stdio \
  --env MIDNIGHT_API_KEY=your-key-here \
  --env MIDNIGHT_API_URL=http://localhost:8080/api/v2 \
  -- uv --directory /absolute/path/to/minecraft-mcp-server run server.py

Installation überprüfen

Überprüfen Sie in Claude Code, ob der Server läuft:

/mcp

Sie sollten midnight mit dem Status ✓ Connected aufgelistet sehen.

Beispielkonversationen

Befehle ausführen:

You: "Change my gamemode to creative"
Claude: [Uses execute_command("gamemode creative")]
        ✓ Command executed successfully

Befehlshilfe erhalten:

You: "How do I use the island upgrade command?"
Claude: [Uses execute_command("island upgrade help")]
        Shows the help output for island upgrade

Befehle erkunden:

You: "What island commands are available?"
Claude: [Uses tab_complete("island ")]
        Lists: upgrade, create, delete, invite, members...

Konfiguration

Umgebungsvariablen

API-Endpunkte

• POST /api/v2/command/execute — Befehle ausführen

• POST /api/v2/command/tabComplete — Tab-Vervollständigungen abrufen

Fehlerbehebung

"MIDNIGHT_API_KEY environment variable not set!"

Erstellen Sie eine .env-Datei:

echo "MIDNIGHT_API_KEY=your-key-here" > .env

"Failed to execute command"

Überprüfen Sie Folgendes:

1. Die MasterControl-API läuft

2. Der API-Schlüssel ist korrekt

3. Der Spieler ist online und auf einem Server (nicht im Proxy-Limbo)

Sicherheit

• Committen Sie niemals .env — es enthält Ihren API-Schlüssel (bereits über .gitignore ausgeschlossen)

• Befehle werden mit den Berechtigungen Ihres Spielers ausgeführt

• Die KI kann jeden Befehl ausführen, den Sie auch im Spiel ausführen können