Minecraft MCP-Server

https://github.com/user-attachments/assets/6f17f329-3991-4bc7-badd-7cde9aacb92f

Ein Minecraft-Bot, der von großen Sprachmodellen und der Mineflayer-API angetrieben wird. Dieser Bot nutzt das Model Context Protocol (MCP), damit Claude und andere unterstützte Modelle einen Minecraft-Charakter steuern können.

Voraussetzungen

• Git

• Node.js (>= 20.10.0)

• Ein laufendes Minecraft-Spiel (das unten beschriebene Setup wurde mit der Minecraft 1.21.8 Java Edition getestet, die im Microsoft Game Pass enthalten ist)

• Ein MCP-kompatibler Client. Claude Desktop wird als Beispiel verwendet, aber andere MCP-Clients werden ebenfalls unterstützt.

Related MCP server: MCP Server

Erste Schritte

Dieser Bot ist für die Verwendung mit Claude Desktop über das Model Context Protocol (MCP) konzipiert.

Minecraft ausführen

Erstelle eine Einzelspieler-Welt und öffne sie für LAN (ESC -> Im LAN öffnen). Der Bot versucht, sich über den Port 25565 und den Hostnamen localhost zu verbinden. Diese Parameter können im nächsten Schritt in der claude_desktop_config.json konfiguriert werden.

MCP-Konfiguration

Stelle sicher, dass Claude Desktop installiert ist. Öffne File -> Settings -> Developer -> Edit Config. Dies sollte das Installationsverzeichnis öffnen. Suche die Datei mit dem Namen claude_desktop_config.json und füge den folgenden Code ein:

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

Überprüfe noch einmal, ob die richtigen --port- und --host-Parameter verwendet wurden. Stelle sicher, dass die Claude Desktop-Anwendung vollständig neu gestartet wird (sie sollte im System-Tray geschlossen werden).

Ausführung

Stelle sicher, dass das Minecraft-Spiel läuft und die Welt für LAN geöffnet ist. Starte dann die Claude Desktop-Anwendung, und der Bot sollte dem Spiel beitreten.

Es kann einige Zeit dauern, bis Claude Desktop den MCP-Server gestartet hat. Das Zeichen dafür, dass der Server erfolgreich gestartet wurde:

Du kannst dem Bot über jeden aktiven Claude Desktop-Chat Befehle geben. Du kannst auch Bilder von Gebäuden hochladen und den Bot bitten, diese zu bauen 😁

Vergiss nicht, in deinem Prompt zu erwähnen, dass der Bot etwas in Minecraft tun soll. Denn dies ist der Auslöser, um den MCP-Server zu starten. Er wird dich um deine Erlaubnis bitten.

Die Verwendung von Claude Sonnet kann zu interessanten Ergebnissen führen. Der Bot-Agent wird wirklich intelligent sein 🫡

Beispiel für die Verwendung: geteilter Claude-Chat

Verfügbare Befehle

Sobald Claude mit einem Minecraft-Server verbunden ist, kann er diese Befehle verwenden:

Bewegung

• get-position - Aktuelle Position des Bots abrufen

• move-to-position - Zu bestimmten Koordinaten bewegen

• look-at - Den Bot dazu bringen, auf bestimmte Koordinaten zu schauen

• jump - Den Bot springen lassen

• move-in-direction - Für eine bestimmte Dauer in eine bestimmte Richtung bewegen

Flug

• fly-to - Den Bot direkt zu bestimmten Koordinaten fliegen lassen

Inventar

• list-inventory - Alle Gegenstände im Inventar des Bots auflisten

• find-item - Einen bestimmten Gegenstand im Inventar finden

• equip-item - Einen bestimmten Gegenstand ausrüsten

Block-Interaktion

• place-block - Einen Block an den angegebenen Koordinaten platzieren

• dig-block - Einen Block an den angegebenen Koordinaten abbauen

• get-block-info - Informationen über einen Block abrufen

• find-blocks - Einen oder mehrere Blöcke eines bestimmten Typs in der Nähe finden

Ofen

• smelt-item - Gegenstände mit einem ofenartigen Block schmelzen

Entitäts-Interaktion

• find-entity - Die nächste Entität eines bestimmten Typs finden

Kommunikation

• send-chat - Eine Chat-Nachricht im Spiel senden

• read-chat - Aktuelle Chat-Nachrichten von Spielern abrufen

Spielstatus

• detect-gamemode - Den Spielmodus im Spiel erkennen

Mitwirken

Fühle dich frei, Pull Requests einzureichen oder Issues für Verbesserungen zu öffnen. Alle Refactoring-Commits, funktionale und Test-Beiträge, Issues und Diskussionen sind sehr willkommen!

Um mit dem Mitwirken zu beginnen, lies bitte CONTRIBUTING.md.

⭐ Wenn du dieses Projekt nützlich findest, gib ihm bitte einen Stern auf GitHub! ⭐

Deine Unterstützung hilft dabei, dieses Projekt für andere Leute sichtbarer zu machen, die davon profitieren könnten.