Claude MCP

Dein Minecraft-Client als MCP-Server – gesteuert von Claude Code, opencode oder jedem anderen MCP-Client.

Claude läuft per Pathfinder durch die Welt – oben links zeigt das HUD, was gerade passiert.

Eine clientseitige Fabric-Mod, die in Minecraft einen MCP-Server startet. Ein KI-Agent kann damit den laufenden Client komplett übernehmen. Er sieht die Welt und läuft, baut ab, baut, craftet und kämpft. Er merkt sich Orte pro Welt. Und er greift live in den Code des Spiels ein: Java-Methoden aufrufen, Groovy-Code ausführen, beliebige Methoden zur Laufzeit hooken, den Chat filtern und NBT bearbeiten.

„Hau den nächsten Baum um, bau eine Werkbank und merk dir, wo sie steht.“ „Hook LivingEntity.getHealth und zeig mir, wer wie oft abgefragt wird.“ „Ersetze jedes ‚lol‘ im Chat durch ‚😂‘.“

Gleichzeitig aktiv: ein Live-Groovy-HUD (oben rechts), ein Methoden-Hook, der Chatzeilen umschreibt ([java_hook]), und ein Chat-Filter.

Lege in einer Fabric-Instanz für Minecraft 26.3 (z. B. mit Prism Launcher) diese Dateien in mods/:

• claude-mcp-<version>.jar – aktuelles Release herunterladen oder selbst bauen mit .\gradlew build (die Jar liegt dann unter build/libs/)
• Fabric API ≥ 0.165.0

Starte Minecraft einmal. Dabei werden config/claudemcp/token.txt und config.json angelegt.

.\register.ps1                                         # sucht die Prism-Instanz "Fabric 26.3"
.\register.ps1 -ConfigDir "<instanz>\minecraft\config\claudemcp"

Das Skript trägt den Server als minecraft im User-Scope ein. Optional kopierst du den Skill skill/minecraft-control nach ~/.claude/skills/. Er bringt Claude bei, wie die Tools sinnvoll zusammenspielen.

In ~/.config/opencode/opencode.json:

"mcp": {
  "minecraft": {
    "type": "remote",
    "url": "http://127.0.0.1:25599/mcp",
    "headers": { "Authorization": "Bearer {file:<instanz>/minecraft/config/claudemcp/token.txt}" },
    "enabled": true
  }
}

💡 Tipp für lokale Modelle: 73 Tool-Beschreibungen kosten viel Kontext. Schalte nicht benötigte Tools über "tools": { "minecraft_goto": false, … } ab.

Minecraft starten, eine Welt betreten und dem Agenten sagen, was er tun soll. Der Server existiert nur, solange das Spiel läuft.

java_hook patcht jede Methode des Spiels oder einer Mod, ohne Neustart. Ein Java-Agent hängt sich per Self-Attach an den laufenden Prozess, und Byte Buddy schreibt die Klasse per Retransformation um.

// Nur mitschneiden, wer getHealth() aufruft – Ergebnisse mit java_hook_calls
{ "class": "LivingEntity", "method": "getHealth", "max_calls": 100 }

// Rückgabewert ersetzen
{ "class": "LivingEntity", "method": "getHealth",
  "after": "if (self instanceof net.minecraft.client.player.LocalPlayer) hook.setResult(7.5)" }

// Argumente umschreiben
{ "class": "ChatComponent", "method": "addClientSystemMessage",
  "before": "args[0] = net.minecraft.network.chat.Component.literal('[hook] ' + args[0].string)" }

• before: Variablen self, args, method, hook. Mit hook.cancel(wert) wird das Original übersprungen.
• after: zusätzlich result und thrown. Mit hook.setResult(wert) wird der Rückgabewert ersetzt.
• Entfernt man den letzten Hook einer Methode, ist der Original-Bytecode wieder da.
• Hooks laufen auf dem aufrufenden Thread mit 50 ms Limit und schalten sich nach 5 Fehlern selbst ab.
• JDK-Klassen und die Mod selbst sind tabu. Falls sich der Agent nicht anhängen kann, hilft das JVM-Argument -Djdk.attach.allowAttachSelf=true.

// nächste 5 Stämme fällen
5.times {
  def log = api.findBlocks("oak_log", 24, 1)
  if (!log) return
  def p = log[0].pos
  api.mine(p[0], p[1], p[2])
}
api.inventory().items.findAll { it.id.endsWith("_log") }

Verfügbar sind mc, player, level, gameMode, screen, api, memory, args und out. Game-Objekte fasst man in Worker-Scripts innerhalb von api.onMain { … } an. Mit sync: true läuft kurzer Code direkt im Client-Thread.

// Kiste umbenennen und füllen
nbt_set  { "target": "block", "x": -12, "y": 70, "z": 17,
           "snbt": "{CustomName:\"Claudes Kiste\",Items:[{Slot:0b,id:\"minecraft:diamond\",count:42}]}" }

// Item mit Komponenten erzeugen
nbt_give { "snbt": "{id:\"minecraft:diamond_sword\",count:1,components:{\"minecraft:custom_name\":\"Excalibur\"}}" }

flowchart LR
    A[Claude Code / opencode] -- "Streamable HTTP + Bearer-Token" --> B["Jetty + MCP Java SDK<br/>127.0.0.1:25599"]
    subgraph Minecraft-Client
        B --> C[73 Tools]
        C --> D[Task-Manager<br/>Tick-Tasks & Worker]
        C --> E[Reflection<br/>Handles]
        C --> F[Groovy<br/>Scripts & Hooks]
        C --> G[Java-Agent<br/>Byte Buddy]
        D --> H[(Client-Thread)]
        E --> H
        F --> H
        G -.retransform.-> H
    end

• Der Server lauscht nur auf 127.0.0.1 und verlangt ein zufälliges Bearer-Token.
• Scripts und Reflection bedeuten volle Codeausführung im Spielprozess. Beides lässt sich in config/claudemcp/config.json abschalten (enableScripts, enableReflection).
• Die Mod ist rein clientseitig und funktioniert in Singleplayer und auf Servern. Anticheat-Umgehung ist bewusst nicht eingebaut. Halte dich an die Regeln der Server, auf denen du spielst.

.\gradlew build                 # Jar + Unit-Tests (Pathfinder, Overloads, Memory/Events, NBT)
.\gradlew runClient             # Dev-Client (run/), MCP auf Port 25599
.\gradlew runClientGameTest     # End-to-End: echter Client, Testwelt, alle Kernfunktionen über MCP-HTTP

Copyright 2026 Hemiize · Apache License 2.0

Die mitgelieferten Bibliotheken behalten ihre eigenen Lizenzen (MCP Java SDK, Jetty, Groovy, Byte Buddy, Jackson, Reactor). Minecraft ist eine Marke von Mojang/Microsoft. Dieses Projekt ist inoffiziell und steht in keiner Verbindung zu Mojang, Microsoft oder Anthropic.