这是一份面向新手的完整教程。你不需要会写代码,只需要复制命令和发自然语言指令。
一、你将实现什么
- 把
mineflayer_mcp接入 Codex - 用自然语言让 AI 自动进服、移动、建造
- 在创造模式下让 AI 建大型建筑(庄园、教堂等)
二、环境准备(5 分钟)
请先准备:
Node.js >= 22pnpm- 可运行的 Minecraft 服务器(建议先离线服测试,
auth=offline)
三、拉取项目
git clone --recurse-submodules https://gitlab.com/viloze/mineflayer_mcp.git
cd mineflayer_mcp
如果你之前没带子模块拉取,再执行:
git submodule update --init --recursive
安装依赖:
pnpm install
四、推荐 Codex API 配置
自行购买
五、把 MCP 添加到 Codex
codex mcp add mineflayer -- node /你的绝对路径/mineflayer_mcp/src/index.js
检查是否成功:
codex mcp list --json
六、开始让 AI 玩游戏(自然语言)
进 Codex 后直接发送:
不要让我提供函数名,你自己调用 mineflayer MCP 工具执行。
连接 127.0.0.1:25565,用户名 mcp-bot,auth=offline。
连接成功后先汇报坐标和状态,再开始建造一个大型中世纪风格建筑。
你也可以直接给具体目标:
换一个远一点的地方,仔细分析地形后,建一个超级巨大的中世纪欧洲庄园。
要求包含完整家具、照明、功能区,材料兼顾美观和真实性。
七、常见问题
1)Node 版本报错
项目要求 Node 22+,请先切换 Node 版本再安装。
2)找不到 submodule
执行:
git submodule update --init --recursive
3)AI 不执行动作
确认三点:
- MCP 已成功添加
- Minecraft 服务器可连接
- 账号权限足够(需要执行命令时需 OP)
八、效果图展示(AI 自动建造)
这是 AI 构建的教堂,纯AI 无干预:

