MCP Minecraft Remote

MCP Minecraft-Fernbedienung

Dieses Projekt ist von mcp-minecraft von arjunkmrm inspiriert. Während das Original nur lokale Minecraft-Serververbindungen unterstützte, wurde dieses Projekt von Grund auf neu erstellt, um die Verbindung zu entfernten Minecraft-Servern zu ermöglichen.

Minecraft-Fernsteuerung mit MCP (Model Context Protocol).

Merkmale

• Stellen Sie eine Verbindung zu einem Minecraft-Player her und steuern Sie ihn über einen KI-Assistenten
• Navigieren, schürfen, bauen und interagieren Sie mit der Minecraft-Welt
• Chatten Sie mit anderen Spielern auf dem Server
• Überprüfen Sie Inventar, Spielerposition und Serverinformationen
• Erweiterte Bewegungssteuerung, einschließlich Springen, Schleichen und Sprinten
• Interaktion mit Entitäten, einschließlich Angreifen und Folgen
• Behälternutzung (Truhen, Öfen etc.)
• Herstellung von Gegenständen und Handel mit Dorfbewohnern
• Detaillierte Bestandsverwaltung

Installation

Schnellinstallation (empfohlen)

Folgen Sie den CLI-Anweisungen, um die Einrichtung abzuschließen.

Manuelle Installation

Verwendung

Verwendung mit Claude Desktop

1. Navigieren Sie zur Claude Desktop-Konfigurationsdatei:
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Fügen Sie die Minecraft Remote MCP-Konfiguration zu Ihrer Konfigurationsdatei hinzu:

Wenn Sie es global installiert haben:

Wenn Sie das Repository lokal geklont haben:

3. Speichern Sie die Datei und starten Sie Claude Desktop neu
4. Starten Sie eine neue Unterhaltung mit Claude und beginnen Sie mit der Verwendung der Minecraft-Steuerbefehle

Wichtige Serveranforderungen

• Server-Onlinemodus : Der Minecraft-Server muss in der Datei server.properties den online-mode=false haben. Dadurch kann sich der Bot ohne Authentifizierung mit den Sitzungsservern von Minecraft verbinden.
• Wenn Sie einen Server mit Authentifizierung verwenden, müssen Sie beim Verbinden gültige Anmeldeinformationen für Ihr Premium-Konto angeben.

Verfügbare Tools

Kernfunktionalität

• connectToServer : Verbindung zu einem Minecraft-Server mit angegebenen Anmeldeinformationen herstellen
• disconnectFromServer : Trennen Sie die Verbindung zum Minecraft-Server
• sendChat : Senden Sie eine Chat-Nachricht an den Server
• getServerInfo : Informationen über den verbundenen Server abrufen

Bewegung

• getPosition : Aktuelle Spielerposition abrufen
• moveTo : Zu bestimmten Koordinaten bewegen
• moveControl : Grundlegende Bewegungssteuerung (vorwärts, rückwärts, links, rechts, springen, sprinten, schleichen, stoppen)
• lookAt : Lassen Sie den Spieler in eine bestimmte Richtung oder auf Koordinaten schauen

Weltinteraktion

• digBlock : Bauen Sie einen Block an bestimmten Koordinaten ab
• placeBlock : Platzieren Sie einen Block an bestimmten Koordinaten

Bestandsverwaltung

• checkInventory : Grundlegende Bestandsprüfung
• inventoryDetails : Erhalten Sie detaillierte Informationen zu Inventargegenständen
• equipItem : Rüste einen Gegenstand aus dem Inventar in den Hand- oder Rüstungsslot aus
• tossItem : Gegenstände aus dem Inventar werfen

Entitätsinteraktion

• getNearbyPlayers : Liste der Spieler in der Nähe abrufen
• getNearbyEntities : Ruft eine Liste aller Entitäten in der Nähe ab
• attackEntity : Greife eine bestimmte Entität an
• useOnEntity : Verwendet gehaltenes Element für eine bestimmte Entität
• followEntity : Folgen Sie einer bestimmten Entität

Container-Interaktion

• openContainer : Öffnen Sie einen Container (Truhe, Ofen usw.) an bestimmten Koordinaten
• withdrawItem : Nimm Gegenstände aus einem offenen Behälter
• depositItem : Gegenstände in einen offenen Behälter legen
• closeContainer : Schließt den aktuell geöffneten Container

Basteln

• getRecipes : Holen Sie sich eine Liste der verfügbaren Handwerksrezepte
• craftItem : Erstelle einen Gegenstand aus verfügbaren Materialien

Handel

• listTrades : Listet verfügbare Trades von einem Dorfbewohner in der Nähe auf
• tradeWithVillager : Handeln Sie mit einem Dorfbewohner in der Nähe

Beispiel-Eingabeaufforderungen

Grundlegende Bedienelemente

• „Verbinde dich mit dem Minecraft-Server unter play.example.com mit dem Benutzernamen player1.“
• „Was ist meine aktuelle Position im Spiel?“
• „Bewege mich zu den Koordinaten x=100, y=64, z=-200“
• „Lass mich 3 Sekunden lang vorwärts gehen“
• „Lass mich springen und auf diesen Berg zusprinten“

Inventar & Artikel

• „Überprüfen Sie im Detail, was sich in meinem Inventar befindet“
• „Gib mir mein Diamantschwert in die Hand“
• „Wirf 5 Erdblöcke aus meinem Inventar“

Blockinteraktion

• „Grabe den Block bei den Koordinaten x=10, y=65, z=20“
• „Platziere einen Steinblock bei den Koordinaten x=11, y=65, z=20“

Entitätsinteraktion

• „Sind andere Spieler in der Nähe?“
• „Welche Einrichtungen befinden sich im Umkreis von 20 Blocks um mich herum?“
• „Greife den Zombie mit der ID 12345 an“
• „Folge dem Spieler namens Steve“

Containernutzung

• „Öffne die Truhe bei den Koordinaten x=100, y=64, z=200“
• „Nimm 10 Eisenbarren aus der Truhe“
• „Lege 5 Pflastersteine in die Truhe“
• "Container schließen"

Handwerk und Handel

• „Welche Rezepte stehen mir für eine Holzspitzhacke zur Verfügung?“
• „Stelle 4 Stöcke aus dem Holz in meinem Inventar her.“
• „Schauen Sie nach, welche Handelsgeschäfte der Dorfbewohner in der Nähe anbietet.“
• „Handeln Sie mit dem Dorfbewohner, um 10 Smaragde zu bekommen.“

Kommunikation

• „Sende eine Hallo-Nachricht an den Chat“
• „Erzähl allen, dass ich Diamanten gefunden habe“

Anforderungen

• Node.js 18+
• Ein KI-Assistent, der MCP unterstützt (wie Claude)
• Ein Minecraft Java Edition-Server (Version 1.8 oder höher)

Hinweis : Dieses Tool wurde speziell für die Version 1.21 von Vanilla Minecraft getestet und funktioniert einwandfrei. Es funktioniert möglicherweise auch mit anderen Versionen oder modifizierten Servern, die Kompatibilität ist jedoch nicht gewährleistet.

Lizenz

MIT