mcp-minecraft

Minecraft MCP-Server

⚠️ WICHTIGER KOMPATIBILITÄTSHINWEIS : Am 25. März 2025 wurde Minecraft 1.21.5 veröffentlicht. Dieser Bot ist derzeit NICHT mit Minecraft 1.21.5 kompatibel . Bitte verwenden Sie Minecraft 1.21.4, bis wir ein Update mit 1.21.5-Unterstützung veröffentlichen.

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

Ein Minecraft-Bot, der auf umfangreichen Sprachmodellen und der Mineflayer-API basiert. Dieser Bot verwendet das Model Context Protocol (MCP), um Claude und anderen unterstützten Modellen die Steuerung eines Minecraft-Charakters zu ermöglichen.

Voraussetzungen

• Git
• Node.js
• Ein laufendes Minecraft-Spiel (das folgende Setup wurde mit Minecraft 1.21.4 Java Edition getestet, das im Microsoft Game Pass enthalten ist)
• Claude Desktop

Erste Schritte

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

Minecraft ausführen

Erstelle eine Einzelspielerwelt und öffne sie für das LAN ( ESC -> Open to LAN ). Der Bot versucht, eine Verbindung über Port 25565 und den Hostnamen localhost herzustellen. Diese Parameter können im nächsten Schritt in claude_desktop_config.json konfiguriert werden.

MCP-Konfiguration

Stellen Sie sicher, dass Claude Desktop installiert ist. Öffnen Sie File -> Settings -> Developer -> Edit Config . Das Installationsverzeichnis sollte geöffnet werden. Suchen Sie die Datei claude_desktop_config.json und fügen Sie den folgenden Code ein:

Überprüfen Sie, ob die richtigen Parameter --port und --host verwendet wurden. Stellen Sie sicher, dass die Claude Desktop-Anwendung vollständig neu gestartet wird (sie sollte in der Taskleiste geschlossen sein).

Läuft

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

Es kann einige Zeit dauern, bis Claude Desktop den MCP-Server startet. Der erfolgreiche Start wird durch ein Hammersymbol neben dem Chat angezeigt.

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

Vergessen Sie nicht, in Ihrer Eingabeaufforderung zu erwähnen, dass der Bot etwas in Minecraft tun soll. Denn dies ist ein Auslöser für den Start des MCP-Servers. Sie werden nach Ihren Berechtigungen gefragt.

Die Verwendung von Claude 3.7 Sonnet könnte Ihnen einige interessante Ergebnisse liefern. Der Bot-Agent wäre wirklich intelligent 🫡

Anwendungsbeispiel: gemeinsamer Claude-Chat

Verfügbare Befehle

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

Bewegung

• get-position - Aktuelle Position des Bots ermitteln
• move-to-position - Zu bestimmten Koordinaten bewegen
• look-at - Lassen Sie den Bot auf bestimmte Koordinaten schauen
• jump - Lass den Bot springen
• move-in-direction - Bewegen Sie sich für eine Dauer in eine bestimmte Richtung

Flug

• enable-flight – Flugmodus für den Bot aktivieren (erfordert Kreativmodus)
• disable-flight - Flugmodus für den Bot deaktivieren
• fly-to - Lassen Sie den Bot direkt zu bestimmten Koordinaten fliegen

Inventar

• list-inventory – Listet alle Gegenstände im Inventar des Bots auf
• find-item - Einen bestimmten Gegenstand im Inventar finden
• equip-item - Rüste einen bestimmten Gegenstand aus

Blockinteraktion

• place-block - Platzieren Sie einen Block an den angegebenen Koordinaten
• dig-block - Grabe einen Block an angegebenen Koordinaten
• get-block-info - Informationen zu einem Block abrufen
• find-block - Findet den nächstgelegenen Block eines bestimmten Typs

Entitätsinteraktion

• find-entity - Findet die nächstgelegene Entität eines bestimmten Typs

Kommunikation

• send-chat - Senden Sie eine Chat-Nachricht im Spiel

Beitragen

Diese Anwendung wurde in nur zwei Tagen erstellt, und der Code ist wirklich einfach und unkompliziert. Alle Refactoring-Commits, Funktions- und Testbeiträge, Probleme und Diskussionen sind sehr willkommen!

Senden Sie uns gerne Pull Requests oder offene Probleme für Verbesserungen. Einige Bereiche, die verbessert werden könnten:

• Zusätzliche Dokumentation
• Robustere Fehlerbehandlung
• Tests für verschiedene Komponenten
• Neue Funktionen und Befehle