MCP server that lets AI play Minecraft well-enough to beat the game!
概览
Batteries-included MCP runtime for letting AI play Minecraft. Mine AI MCP provides external AI agents with reliable, observable tools to inspect, navigate, and act in Minecraft. Every tool reports what was directly observed in the game world. An agent running this server played a fresh world through to the Ender Dragon in a single unbroken session. The recording of that run is on YouTube, and its complete artifacts — the agent's transcript, the runtime's SQLite database, the server logs, and the seed prompt — are published as a dataset on Hugging Face. [video]: https://www.youtube.com/watch?v=ZjtwWEfFVFY [dataset]: https://huggingface.co/datasets/aibengineering/beat-the-game-minecraft Run it straight from the public repository with Bun. The package executes its TypeScript source, so there is no build step: This starts a persistent MCP host at http://localhost:25575/mcp and joins the specified Minecraft Java server.
README
以下为原文 README 节选，完整内容请查看原文。
Mine AI MCP
Batteries-included MCP runtime for letting AI play Minecraft. Mine AI MCP provides external AI agents with reliable, observable tools to inspect, navigate, and act in Minecraft. Every tool reports what was directly observed in the game world.
An agent running this server played a fresh world through to the Ender Dragon in a single unbroken session. The recording of that run is on YouTube, and its complete artifacts — the agent’s transcript, the runtime’s SQLite database, the server logs, and the seed prompt — are published as a dataset on Hugging Face.
Quick start: use an existing Minecraft server
Run it straight from the public repository with Bun. The package executes its TypeScript source, so there is no build step:
bunx github:aibengineering/mine-ai-mcp --minecraft-host 127.0.0.1 --minecraft-port 25565 --username MineAI --version 1.21.4
This starts a persistent MCP host at http://localhost:25575/mcp and joins the
specified Minecraft Java server. Keep it running, then connect your AI client
using the examples below. Pin a commit for reproducible runs, for example
github:aibengineering/mine-ai-mcp#.
The default --auth offline is for offline-mode servers; use --auth microsoft
with a Minecraft account for a server that requires authenticated players.
You need Bun 1.4 or newer, a reachable Minecraft Java server (tested with 1.21.4), and Git for the current Git-pinned dependencies. Bun installs the JavaScript dependencies automatically. You do not need a separate Node runtime, Java installation, Docker, Claude Code, or Mine Labs to run just this MCP host; Java is needed wherever you host the Minecraft server itself. Use whichever MCP client you prefer to control the bot.
bunx downloads missing packages into Bun’s shared
cache without adding them to your project’s dependencies. It still downloads
and executes code; the cache is not an isolated sandbox. Persistent bot data goes
to ~/.mine-ai/bot-data, separate from the cache; override it with --data-root.
From a source checkout, install dependencies and run the same entry point:
bun install
bun src/server/host.ts --minecraft-host 127.0.0.1 --minecraft-port 25565 --username MineAI --version 1.21.4
Complete documentation lives in docs/mcp/README.md.
Tool output schemas use compact local references by default. If a client has
incompatible reference handling, add --inline-output-schemas to the host command
to restore the previous SDK representation. Actual Claude/Codex host compatibility
with this catalogue remains unverified; see the
schema compatibility notes.
Run a local Claude playthrough with the Docker playthrough setup.
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"minecraft": {
"type": "http",
"url": "http://localhost:25575/mcp",
"timeout": 3600000
}
}
}