minecraft-mcp

这是什么？适合谁？

Minecraft MCP（lolifamily/Minecraft-MCP）是一个操控 Minecraft 世界的 MCP 服务器：进程内 MCP 服务器 + Kotlin REPL：让 AI 直接操控 Minecraft 世界（建筑、逻辑、调试）。MIT，官网 minecraft-mcp.lolifamily.js.org。游戏 + Agent 的可玩性结合。

核心价值：以进程内 MCP 服务器 + Kotlin REPL 让 AI 直接操控 Minecraft 世界，用于建筑、逻辑与调试，是游戏与 Agent 结合的有趣方向。

适合人群：

• 用 AI 玩/调试 Minecraft 的玩家
• 做 Minecraft 自动化与插件的开发者
• 研究游戏世界 Agent 操控的研究者

使用前提：Minecraft 服务端/客户端与 Kotlin 运行环境；官网提供说明

准备工作

1. 安装：从 GitHub 克隆 Minecraft-MCP
2. 环境：Java/Kotlin 运行时 + Minecraft
3. 客户端：支持 MCP 的 AI 客户端
4. 成本：MIT 开源免费
5. 时间：安装 + 连接世界约 20 分钟

快速上手（3 步）

第一步：克隆并构建

git clone https://github.com/lolifamily/Minecraft-MCP && cd Minecraft-MCP

克隆仓库并按 README 构建 MCP 服务器。

第二步：连接 Minecraft 世界

# 启动服务器并连接到你的 Minecraft 实例

把 MCP 服务器接入 Minecraft 世界。

第三步：让 AI 操控世界

# 对 Agent 说：在出生点附近建一座 5x5 的石屋

用自然语言让 AI 通过 MCP 操控世界（建筑/逻辑/调试）。

成功判定：AI 成功连接 Minecraft 世界并完成一次操控（如放置方块或执行逻辑）。

初级用法

方块放置与建筑

让 AI 按指令放置方块、搭建结构。

世界状态查询

读取坐标、方块与环境状态。

逻辑执行

通过 Kotlin REPL 执行游戏内逻辑。

高级玩法

程序化建筑生成

用 REPL 生成复杂建筑与地形结构。

游戏机制调试

让 AI 辅助调试红石电路与游戏逻辑。

Agent 自主玩法

让 Agent 在开放世界自主探索与建造。

小技巧

1. 1. 在测试存档里先试，别动主力存档
2. 2. 限制 AI 的操作范围，避免破坏建筑
3. 3. 复杂建筑先画草图再让 AI 执行
4. 4. 关注服务器性能与方块操作频率
5. 5. 结合 REPL 做批量操作，别逐方块调用

常见踩坑

踩坑 1：误操作破坏存档

• 现象：AI 拆错建筑
• 原因：操作范围未限制
• 解决：在测试存档操作并加边界约束

踩坑 2：性能问题

• 现象：方块操作卡顿
• 原因：逐方块调用太频繁
• 解决：用 REPL 批量操作

踩坑 3：版本不匹配

• 现象：连不上 Minecraft
• 原因：MCP 与游戏版本不对应
• 解决：对齐游戏版本

踩坑 4：坐标理解偏差

• 现象：AI 建错位置
• 原因：坐标系理解不一致
• 解决：先让 AI 读坐标确认再操作

踩坑 5：项目较新

• 现象：功能有限
• 原因：2026-08 新建，12 星
• 解决：以 README/官网为准

常见问题 FAQ

Q1: 它能做什么？

A: 让 AI 操控 Minecraft 世界做建筑、逻辑与调试。

Q2: 免费吗？

A: MIT 开源免费。

Q3: 需要哪些环境？

A: Minecraft 与 Java/Kotlin 运行时，详见官网。

Q4: 支持联机吗？

A: 取决于 MCP 与 Minecraft 实例的连接方式，以 README 为准。

Q5: 适合生产吗？

A: 偏可玩性与研究，生产意义有限。

进阶学习建议

掌握基础后，建议深入：

1. 1. 研究 Kotlin REPL 与游戏世界的交互模型
2. 2. 探索程序化建筑与地形生成的算法
3. 3. 对比其他游戏 Agent 操控框架的实现

参考链接

• 官方仓库

最后更新：2026-09-01 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成