开源项目 minecraft-mcp-server 通过 Model Context Protocol 将 AI Agent 接入真实 Minecraft 世界,支持 61 种工具操作,任何 MCP 兼容客户端(Claude Code、Cursor、Cline 等)均可控制游戏内机器人。
minecraft-mcp-server 是一个 Model Context Protocol 服务器,它通过 mineflayer 将 AI Agent 嵌入到真实的 Minecraft Java 版世界中。它对外暴露了 61 个工具,涵盖移动、建筑、挖矿、战斗、农耕、背包、村名交易和世界感知——因此任何兼容 MCP 的客户端都可以生成一个能够真实感知世界、行走其中并对其采取行动的 Bot。
它不依赖任何单一的 AI 产品。它通过 stdio 传输标准 MCP 协议,因此可以与任何 MCP Host 配合使用——Claude Desktop、Claude Code、Cursor、Cline、Windsurf、你自己的自定义 MCP 客户端,或任何能够启动本地 MCP 服务器的工具。只要你的 Agent 能说 MCP,它就能玩 Minecraft。
适用于通过「开放到局域网」打开的单人世界、离线模式/破解服务器(如 TLauncher)以及标准在线模式服务器。
每个工具都返回结构化 JSON 和可操作的错误信息——不会把原始堆栈跟踪倾倒给你的 Agent。
git clone https://github.com/AhmadTariq1337/minecraft-mcp-server.git
cd minecraft-mcp-server
npm install
npm run build
这会把 TypeScript 编译为 dist/index.js——你的 MCP Host 将启动的入口文件。
{
"mcpServers": {
"minecraft": {
"command": "node",
"args": ["/absolute/path/to/minecraft-mcp-server/dist/index.js"]
}
}
}
无需 API Key,无云端依赖——一切通过 stdio 本地运行。
打开你的 Minecraft 世界(单人模式效果很好)。
按 ESC → 开放到局域网——记下聊天中显示的端口号。
让 Agent 连接:"Connect to localhost on port <port> as <bot-name>, auth offline."
就这样——你的 Agent 现在可以感知世界、移动、挖矿、建造和聊天了。
这基于 mineflayer 构建,它决定了实际的协议支持。截至发稿,支持到 Minecraft 1.21.x。Mojang 较新的 year.drop 版本命名方式在上游尚未支持——OptiFine 1.21.11 或 vanilla 1.21.x 等较旧的客户端开箱即用。
Repo: https://github.com/AhmadTariq1337/minecraft-mcp-server
采用 MIT 许可,欢迎提交 Issue 和 PR——尤其是在 mineflayer 版本追踪和新工具覆盖方面。