/ Verzeichnis / Playground / minecraft-mcp-server
● Community yuniko-software ⚡ Sofort

minecraft-mcp-server

von yuniko-software · yuniko-software/minecraft-mcp-server

Control a Minecraft bot with Claude — build structures, explore worlds, manage inventory, and interact in real-time via natural language.

minecraft-mcp-server uses the Mineflayer API to let AI assistants control a Minecraft character in real-time. Claude can navigate, build structures, manage inventory, interact with blocks and entities, smelt items, and communicate in chat. Supports Minecraft 1.21.11, connects via LAN to your singleplayer world, and works with Claude Desktop.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

minecraft-mcp-server-2.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "minecraft-mcp-server-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "minecraft-mcp-server-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/yuniko-software/minecraft-mcp-server"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add minecraft-mcp-server-2 -- TODO 'See README: https://github.com/yuniko-software/minecraft-mcp-server'

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: minecraft-mcp-server

How to build a Minecraft structure with AI assistance

👤 Minecraft players who want AI help with building ⏱ ~15 min beginner

Wann einsetzen: You want to build something complex in Minecraft without placing every block manually.

Voraussetzungen
  • Minecraft Java Edition 1.21.11 — Create a singleplayer world and Open to LAN
  • minecraft-mcp-server configured — Add to Claude Desktop config with host, port, and username
Ablauf
  1. Describe the build
    Build a 10x10 stone house with oak wood corners, glass windows on each wall, an oak door, and a flat stone roof. Start at my current position.✓ Kopiert
    → Bot begins placing blocks systematically, reporting progress
  2. Modify the build
    Add a second floor with the same layout and a staircase connecting them.✓ Kopiert
    → Second floor built with stairs

Ergebnis: A complete structure built in Minecraft via natural language instructions.

Fallstricke
  • Bot doesn't have required blocks in inventory — Ensure the bot has materials or switch to Creative mode for unlimited blocks

Send an AI bot to explore and gather resources in Minecraft

👤 Minecraft players who want automated resource gathering ⏱ ~20 min beginner

Wann einsetzen: You need resources but don't want to grind for them.

Voraussetzungen
  • Minecraft world open to LAN with bot connected — Configure and launch
Ablauf
  1. Explore surroundings
    Look around and tell me what biome we're in. Find the nearest cave entrance.✓ Kopiert
    → Biome info and cave location
  2. Gather resources
    Gehen Sie zur Höhle und bauen Sie alles Eisenerz ab, das Sie finden können. Komm zurück und verhütte es zu Eisenbarren.✓ Kopiert
    → Aktualisierungen des Bergbaufortschritts und Schmelzbestätigung

Ergebnis: Resources gathered and processed automatically.

Fallstricke
  • Der Bot bleibt in komplexem Gelände stecken — Verwenden Sie Fly-to für die Navigation über unwegsames Gelände

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

minecraft-mcp-server-2 + filesystem

Speichern Sie Baupläne als Dateien und laden Sie sie für den Bau

Speichern Sie diesen Hausentwurf in einer Datei, damit wir ihn in einer anderen Welt erneut bauen können.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
get-position none Ermitteln Sie die aktuelle Position des Bots 0
move-to-position x: int, y: int, z: int Navigieren Sie zu einer bestimmten Position 0
place-block x: int, y: int, z: int, block_name: str Platzieren Sie einen Block an einer Position 0
dig-block x: int, y: int, z: int Einen Block abbauen/graben 0
list-inventory none Listen Sie Gegenstände im Inventar des Bots auf 0
find-blocks block_name: str, range?: int Finden Sie nahegelegene Blöcke eines Typs 0
send-chat message: str Senden Sie eine Nachricht im Spielchat 0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
N/A – stellt eine direkte Verbindung zum Minecraft-LAN ​​her
Tokens pro Aufruf
100–500 Token pro Aktion
Kosten in €
Kostenloser MCP-Server – erfordert Minecraft Java Edition (26,95 $)
Tipp
Geben Sie eher allgemeine Anweisungen („Bauen Sie ein Haus“) als einzelne Blöcke, um Anrufe zu reduzieren.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: N/A – stellt eine Verbindung zum LAN-Spiel her
Datenabfluss: Stellt nur eine Verbindung zu Ihrem lokalen Minecraft-LAN-Server her

Fehlerbehebung

Häufige Fehler und Lösungen

Bot can't connect to server

Stellen Sie sicher, dass Sie die Welt für LAN geöffnet haben (ESC → Für LAN öffnen) und der Port in Ihrer Konfiguration mit dem im Chat angezeigten LAN-Port übereinstimmt.

Prüfen: Check the Minecraft chat for 'Local game hosted on port XXXXX'
Bot disconnected

Möglicherweise hat der Minecraft-Server den Bot wegen Inaktivität oder ungültigen Aktionen gekickt. Starten Sie Claude Desktop neu, um die Verbindung wiederherzustellen.

Prüfen: Check Minecraft chat for kick messages
Can't place blocks — invalid position

Der Bot ist möglicherweise zu weit von der Zielposition entfernt. Gehen Sie zuerst näher heran mit „Move-to-Position“.

Prüfen: Check bot position relative to target

Alternativen

minecraft-mcp-server vs. andere

AlternativeWann stattdessenKompromiss
Roblox Studio MCPSie möchten KI-gestützte Spieleentwicklung in Roblox statt in MinecraftAndere Plattform und anderes Publikum

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen