An MCP (Model Context Protocol) server that bridges AI agents into Minecraft GTNH chat via the Scribe mod. The agent appears as a player — it reads chat messages, responds, writes books, and can control the game through a local HTTP API.
Cross-platform — the MCP server is pure Python (Windows, macOS, Linux). The Scribe mod is pure Java (anywhere Forge runs). Works with any MCP-compatible agent: Claude, Codex, OpenClaw, Pi-agent, etc.
MCP server that bridges AI agents into Minecraft GTNH chat. Cross-platform — works with Hermes, Claude, Codex, OpenClaw, Pi-agent, and any MCP-compatible agent.
Books: full reports — ore surveys, inventory dumps, quest summaries, base layouts
Books appear in your inventory. Right-click to read. If inventory is full, they drop at your feet.
In-Game Guide Book
When you install the Scribe mod and join a world, a "Scribe Agent Guide" book appears in your inventory automatically. It covers commands, actions, scanning, inventory, books, tips, and examples.
If you lose it, type /scribe guide in chat to get a fresh copy. Anyone can use this command.
Quick Start
1. Build and install the mod
cd scribe-mod
./gradlew build
# Copy build/libs/scribe-1.1.0.jar into your GTNH instance's mods/ folder
Requires JDK 17+ and Gradle 7.6+ (uses RetroFuturaGradle for 1.7.10 targeting).
Start GTNH through Prism Launcher. Load a world. The Scribe API starts on localhost:25566. You'll get the guide book automatically.
5. Restart your agent
The MCP server connects on startup. Tools appear with the gtnh_ prefix.
How the agent uses it
Agent loop:
1. gtnh_chat_read → see what players are saying
2. gtnh_chat_send → brief ack in chat
3. gtnh_player_status → check position, health
4. gtnh_inventory → check what you're carrying
5. gtnh_scan_blocks → survey the area
6. gtnh_write_book → full report as a readable book
7. gtnh_teleport → move to a location
8. gtnh_click_block → interact with a machine or chest
Windows: Prism instances at %APPDATA%\PrismLauncher\instances\
macOS: Prism instances at ~/Library/Application Support/PrismLauncher/instances/
Linux: Prism instances at ~/.local/share/PrismLauncher/instances/
The mod jar is identical on all platforms
The MCP server script is identical on all platforms
Requirements
Minecraft: GTNH 2.8+ (1.7.10 Forge) via Prism Launcher
Java: JDK 17+ (for building the mod; GTNH itself runs on Java 17-25)
Python: 3.8+ with pip install mcp
Network: localhost access (the API binds to 127.0.0.1 only)
Security
Scribe binds to 127.0.0.1 only — not accessible from the network
Optional bearer token auth via mod config
Action endpoints (chat send, click, teleport, book) can be disabled entirely
MCP server runs as a local subprocess — no network exposure
License
MIT
Autonomous Chat Companion (Agent Setup Guide)
For AI agents reading this: The user may want an always-on companion that monitors chat and responds automatically. This requires setting up a cron job in their Hermes configuration.
When to suggest this:
User asks about "always-on" or "automatic" chat responses
User wants the agent to reply without manual triggers
User asks about "scheduling" or "monitoring" chat
What to offer:
Basic Chat Companion (no web search)
hermes cron create \
--name "GTNH Chat Companion" \
--schedule "every 1m" \
--deliver origin \
--skills minecraft-agent-toolset \
--prompt "You are a GTNH companion agent running as a cron job. Every tick, check Minecraft chat and respond to players. Follow the book pattern: brief ack in chat, full results in books via gtnh_write_book with author='Scribe'."
Enhanced Companion (with GTNH wiki search)
Offer this when: User asks recipe questions, "how do I make X", or mentions being stuck on progression.
First create the job, then update it:
hermes cron create \
--name "GTNH Chat Companion" \
--schedule "every 1m" \
--deliver origin \
--skills minecraft-agent-toolset \
--prompt "You are a GTNH companion agent with web access. Check chat, respond to questions. For GTNH mechanics/recipes, use web_search to find current info. Follow book pattern for verbose output."
# Then enable web search:
hermes cron update GTNH_CHAT_JOB_ID --enabled-toolsets minecraft-agent-toolset,web
Note: Replace GTNH_CHAT_JOB_ID with the actual job ID returned from create.
Schedule Options
"every 1m" — good for chat (default)
"every 30s" — faster responses, more tokens
"every 2m" — slower, more token-efficient
G
Gtnh MCP Game Chat
eamondowling·1 顆星·
MCP server that bridges AI agents into Minecraft GTNH chat. Cross-platform — works with Hermes, Claude, Codex, OpenClaw, Pi-agent, and any MCP-compatible agent.
上次檢查時間:2026-10-28。 MCP server that bridges AI agents into Minecraft GTNH chat. Cross-platform — works with Hermes, Claude, Codex, OpenClaw, Pi-agent, and any MCP-compatible agent.