TRAE MCP 实践：让 AI 在 Minecraft 里盖房子

豆包MarsCode2025-08-19 15:40

本文作者：Ray，TRAE 产品经理
本教程演示如何使用 TRAE IDE 通过 MCP 接入 Minecraft，实现自动化建筑搭建，尤其适合大体量结构构建。如有更多适用场景，欢迎补充与分享！

接入 MCP，让 AI 在 Minecraft 里动手干活！本教程手把手教你指挥 AI 搭建空中水族箱，只需一段 Prompt，剩下的交给 TRAE 来搞定！

展示

使用限制

  • Minecraft MCP 最高支持 1.21.4，1.21.5 及以上版本尚不支持

  • 仅测试过 Minecraft Java Edition，基岩版可用性未知

  • 仅测试过 Microsoft 的官方正版 Minecraft，非官方版本可用性未知

准备工作

Minecraft 下载、安装与设置（Mac 版）

购买 Minecraft 国际版

1. 购买 Minecraft 国际版

a. 版本：Minecraft: Java & Bedrock Edition for PC （Mac 也能使用）

2. 购买完成后不用下载官方启动器，Mac 上推荐使用功能更强大的 Prism 启动器

下载 Prism 启动器

1. Mac 版推荐使用第三方开源的 Prism 启动器

a. 官网下载地址： prismlauncher.org/download/ma...

使用 Prism 启动器安装 Minecraft

1. 解压后直接开启 Prism 启动器

2. 登陆 Microsoft 账号（使用购买了 Minecraft 的账号）

3. 首次使用需创建用户名称

4. 安装 Minecraft

a. 首先点击左上角 Add Instance（Prism 启动器特点），选择 1.21.4 版本，可以自定义名称和分组，确认创建。此时页面上会出现创建好的 Instance

b. 右键创建好的 Instance -> Launch -> Launch，首次启动会自动下载安装

运行 Minecraft 并进行基本设置

1. 创建一个世界：Singleplayer -> Create New World ->

a. Game -> Game Mode: Creative

b. Game -> Difficulty: Peaceful（防止怪物破坏建筑）

c. Game -> Allow Commands: ON（务必开启）

d. World -> World Type: Superflat（超平坦地面，方便盖建筑，也可以不选）

2. 通过修改 options.txt 禁用失焦暂停（保证在使用其他应用时，Minecraft 能持续运行）

a. 回到启动器，选择顶部 Folders -> Instances，打开 Instances 文件夹，找到 options.txt 文件，路径：～/1.21.4/minecraft/options.txt

b. 使用文本编辑器打开 options.txt

c. 搜索 pauseon，找到pauseOnLostFocus:true ，修改为pauseOnLostFocus:false，保存

d. 重启 Minecraft，此时切换到别的应用时，Minecraft 也能持续运行

开启 Open to LAN

每次启动 Minecraft 都需要开启一次

Minecraft 进行中按下 ESC -> Open to LAN -> Port Number 输入 25565（或者其他可用端口，需要与接下来的 MCP 配置保持一致）-> Start LAN World

下载 TRAE IDE

有条件的朋友（Pro 会员首月$3）可以下载 TRAE 国际版，使用 Claude 系列模型。官网地址：www.trae.ai/

也可以使用 TRAE 国内版（免费），推荐使用 Doubao seed-1.6 推理模型。官网地址：www.trae.cn/

安装 Node.js

  • 访问 Node.js 官网

  • 下载并安装 LTS 版本

  • 安装完成后使用 Terminal 运行以下命令，若安装成功会返回对应的版本号

    node -v
    npm -v

安装 Minecraft MCP 并创建 Agent

Github 官方项目教程：

github.com/yuniko-soft...

安装 Minecraft MCP

1. 打开 TRAE，找到右侧 AI 对话面板，点击右上角的 AI 功能管理

2. 点击顶部的 MCP，点击添加 -> 手动添加

3. 将 Minecraft MCP 的 Json 粘贴过来，点击确认。（可以将"TraeBot"替换成你喜欢的名字）

json 复制代码 
{
   "mcpServers": {
     "minecraft": { 
       "command": "npx", 
       "args": [ 
         "-y", 
         "github:yuniko-software/minecraft-mcp-server", 
         "--host", 
         "localhost", 
         "--port", 
         "25565", 
         "--username", 
         "TraeBot" 
       ] 
     } 
   } 
}

4. 稍等片刻，MCP 配置完成，点击展开可以查看 MCP 所有可用的工具

创建 Agent

1. 在 AI 对话框输入@，点击创建智能体

2. 修改名称，填写 agent prompt（user rules），勾选刚配置好的 Minecraft MCP

markdown 复制代码 
# Minecraft建筑Agent Prompt

## 角色定义
你是一个专业的Minecraft Java Edition建筑师AI，精通游戏内命令操作和建筑设计。你的任务是根据用户需求，使用MCP工具在Minecraft中自动化搭建各种建筑结构。

## 工作流程

### 第一阶段：需求分析与规划
1. **理解用户需求**：仔细分析用户描述的建筑要求
2. **检测环境**：使用`detect-gamemode`确认游戏模式
3. **获取位置**：使用`get-position`获取当前坐标作为建造起点
4. **创建规划文档**：生成详细的建造计划markdown文件

### 第二阶段：执行建造
1. **按步骤建造**：严格按照规划文档执行
2. **实时反馈**：在每个关键步骤后报告进度
3. **优化调整**：根据实际情况微调建造方案

## 规划文档模板

创建的markdown文件必须包含以下结构：

```markdown
# [项目名称] 建造计划

## 项目概述
- **建筑类型**：[具体描述]
- **建造位置**：[起始坐标]
- **预计用时**：[估算时间]
- **难度等级**：[简单/中等/困难]

## 建造规格
- **整体尺寸**：长 x 宽 x 高 = [具体数值]
- **主要材料**：
  - 材料1：[方块ID] (数量估算)
  - 材料2：[方块ID] (数量估算)
  - ...
- **整体形状**：[详细描述外观特征]
- **特殊结构**：[如有楼梯、门窗等特殊元素]

## 建造步骤
1. **地基建设**
   - 坐标范围：[x1,y1,z1] 到 [x2,y2,z2]
   - 使用命令：`/fill ...`
   
2. **主体结构**
   - [详细步骤描述]
   - 使用命令：[具体命令]
   
3. **重复结构处理**
   - 先建造模板：[坐标范围]
   - 复制命令：`/clone ...`
   
4. **细节装饰**
   - [装饰步骤]
   - 使用命令：[具体命令]

5. **实体与功能添加**
   - 装饰性实体：`/summon armor_stand/item_frame ...`
   - 生物添加：`/summon cow/sheep/chicken/cat ...`
   - 植物景观：`/summon item ~ ~ ~ {Item:{id:"sapling"}} ...`
   - 自定义数据：`/data modify ...`
   - 特殊功能方块设置

## 核心命令清单
[列出本项目将使用的所有关键命令]
```

## 可用工具说明

### 环境检测工具
- `detect-gamemode`：检测当前游戏模式
- `get-position`：获取机器人当前位置坐标

### 移动控制工具  
- `move-to-position`：移动到指定坐标位置

### 命令执行工具
- `send-chat`：发送聊天消息（用于执行游戏命令）

## 核心建造命令

### /fill 命令
- **用途**：填充大面积区域
- **语法**：`/fill <from> <to> <block> [oldBlockHandling] [dataTag]`
- **示例**：`/fill ~0 ~0 ~0 ~10 ~5 ~10 stone`
- **最佳实践**：用于建造墙体、地板、大型实心结构

### /setblock 命令
- **用途**：设置单个方块
- **语法**：`/setblock <pos> <block> [oldBlockHandling] [dataTag]`
- **示例**：`/setblock ~1 ~0 ~1 oak_door[half=lower]`
- **最佳实践**：用于精确放置特殊方块（门、窗、装饰）

### /clone 命令
- **用途**：复制方块区域
- **语法**：`/clone <begin> <end> <destination> [maskMode] [cloneMode]`
- **示例**：`/clone 0 64 0 5 69 5 10 64 0`
- **最佳实践**：用于复制重复结构（柱子、窗户模式等）

### /summon 命令
- **用途**：生成实体（动物、怪物、装饰实体、植物等）
- **语法**：`/summon <entity> [pos] [nbt]`
- **示例**：
  - 装饰实体：`/summon armor_stand ~ ~ ~ {ShowArms:1b,Pose:{RightArm:[0f,0f,0f]}}`
  - 动物：`/summon cow ~ ~ ~ {CustomName:'{"text":"Farm Cow"}',PersistenceRequired:1b}`
  - 植物：`/summon item ~ ~ ~ {Item:{id:"oak_sapling",Count:1b},PickupDelay:32767}`
- **最佳实践**：用于创建农场动物、宠物、装饰生物、植物景观、展示物品

### /data 命令
- **用途**：获取、合并、修改和删除方块实体、实体和命令存储的NBT数据
- **语法**：`/data get|merge|modify|remove <target> [path] [value]`
- **示例**：`/data modify block ~ ~ ~ Items[0].tag.display.Name set value '{"text":"Custom Name"}'`
- **最佳实践**：用于自定义容器内容、修改实体属性、创建特殊功能方块

## 建造策略与技巧

### 1. 分层建造法
- 从下到上逐层建造
- 每层完成后检查效果
- 适用于多层建筑

### 2. 模板复制法
- 先建造一个标准单元
- 使用`/clone`命令复制
- 适用于重复结构（如公寓楼、塔楼）

### 3. 框架填充法
- 先建造建筑轮廓框架
- 再填充墙体和内部结构
- 适用于复杂不规则建筑

### 4. 分区建造法
- 将大型建筑分成多个区域
- 分别完成各区域后整合
- 适用于超大型建筑项目

### 5. 实体装饰法
- 使用`/summon`添加装饰性实体和生物
- 创建农场动物、宠物、景观生物
- 利用盔甲架、物品展示框增强视觉效果
- 添加植物和自然元素（掉落物形式的树苗、花朵等）
- 适用于需要生命力和自然元素的建筑

### 6. 数据驱动定制法
- 使用`/data`命令自定义方块和实体属性
- 创建特殊功能的容器和展示物品
- 适用于功能性建筑（商店、博物馆等）

## 执行规范

### 命令发送规范
1. 所有游戏命令必须通过`send-chat`工具发送
2. 每次发送前确认坐标计算准确
3. 复杂命令分步执行，避免游戏卡顿

### 进度报告规范
1. 每完成一个主要步骤后报告进度
2. 遇到问题时及时说明情况
3. 提供建造过程中的关键坐标信息

### 错误处理规范
1. 命令执行失败时分析原因
2. 提供替代解决方案
3. 必要时调整建造计划
4. 记录问题及解决方法

## 交互示例

**用户**：帮我建造一个10x10x5的石制房屋，带有木门和玻璃窗

**Agent响应流程**：
1. 使用`detect-gamemode`检测游戏模式
2. 使用`get-position`获取当前位置
3. 创建详细的建造规划markdown文档
4. 询问用户确认建造方案
5. 开始执行建造，实时反馈进度

## 注意事项

1. **坐标计算准确性**：所有坐标计算必须精确，避免建造位置错误
2. **环境适应性**：根据地形调整建造方案
3. **性能考虑**：大型建造分批进行，避免游戏卡顿
4. **安全性**：避免在重要建筑附近进行破坏性操作

## 结语

始终记住：你的目标是帮助用户高效、准确地完成Minecraft建筑项目。保持专业、耐心，注重细节，确保每个建造项目都能达到用户期望的效果。

开始使用！

开启 Open to LAN

每次启动 Minecraft 都需要开启一次

Minecraft 进行中按下 ESC -> Open to LAN -> Port Number 输入 25565（或者其他可用端口，需要与 MCP 配置保持一致）-> Start LAN World

刷新 MCP

1. 打开 TRAE 的 MCP 页面，点击刷新

2. Minecraft 页面提示"TraeBot joined the game"，表示已经 MCP server 已连接

Minecraft MCP server 可能不稳定，使用梯子后稳定很多

常用指令

按键盘 T 或 /

  • 让 Bot 移动到指定位置：先操作自己到该位置，再把 Bot 传送过来： /tp TraeBot

  • 改成白天： /time set day

  • 改成晴天： /weather clear

全流程视频演示

  • 使用 Claude-4-Sonnet

  • Agent 的 user rules

  • Prompt:

markdown 复制代码 
建造一个空中的水族箱，长宽高是30*30*45，包含以下结构，需要按照顺序建造：
1. 水族箱底座比bot当前位置高20格，使用泥土铺一层。
2. 在底座上方的最外层建造一圈黑石头的楼梯，4条边的楼梯开口朝上，楼梯背面朝外。
3. 水族箱顶部最外层建造一圈黑石头的楼梯，4条边的楼梯开口朝下，楼梯背面朝外。
4. 将所有楼梯改为浸水状态。
5. 在顶部最外层靠内一格且低一格的位置，中间放置一层泥土。
6. 移除顶层泥土。
7. 在水族箱中增加海洋动物和植物。

亿点点视觉优化

原版材质包，无光影

更清澈的水 + 光影

安装 OpenJDK

1. macOS 推荐使用 Adoptium 提供的 OpenJDK，下载地址：adoptium.net/

2. 安装完成后，在终端输入检查：java -version 。应显示openjdk version "21.x.x" ... 表示安装成功

Instance 添加 Fabric

1. 右键 Instance -> edit

2. 左侧选择 Version，右侧点击 Install Loader

3. 选择 Fabric 版本，确认安装

安装 Shader Mod

1. 下载 。jar 文件，选择对应的 Minecraft 版本 + Fabric

2. Prism Folders 打开 Instances 文件夹，将 。jar 文件放入**～/1.21.4/minecraft/mods** 文件夹中

安装 Shader packs

1. 下载 BSL Shaders，选择对应的 Minecraft 版本 + Iris

2. Prism Folders 打开 Instances 文件夹，将 。zip 文件放入**～/1.21.4/minecraft/shaderpacks** 文件夹中

安装 Resource packs

1. 下载 clear water 材质包，选择对应的 Minecraft 版本

2. Prism Folders 打开 Instances 文件夹，将 。zip 文件放入**～/1.21.4/minecraft/resourcepacks** 文件夹中

开启光影和材质

1. 开启光影：启动 Minecraft -> Options -> Video Settings -> Shader Packs

2. 使用材质包 clear water：启动 Minecraft -> Options -> Resource Packs

附录

MCP 的常用工具

MCP 的全部工具：github.com/yuniko-soft...

Tool Description
detect-gamemode Detect the gamemode in game.
get-position Get the current position of the bot.
move-to-position Move to specific coordinates.
send-chat Send a chat message in-game.

send-chat 工具的常用指令

send-chat 工具的全部指令：minecraft.wiki/w/Commands

Command Description Wiki URL
/clone Copies blocks from one place to another. minecraft.wiki/w/Commands/...
/fill Fills a region with a specific block. minecraft.wiki/w/Commands/...
/setblock Change one block to another block. minecraft.wiki/w/Commands/...
/summon Summons an entity. minecraft.wiki/w/Commands/...
/data Gets, merges, modifies, and removes block entity, entity, and command storage NBT data. minecraft.wiki/w/Commands/...
相关推荐
jifei1 小时前
有了Cursor，为什么还要买摸着Cursor过河的Trae？
cursor·trae
bug菌2 小时前
Trae如何快速辅助Java开发者进场AI编程？打破传统编程思维！
aigc·ai编程·trae
用户4099322502123 小时前
如何用Prometheus和FastAPI打造任务监控的“火眼金睛”？
后端·ai编程·trae
bug菌3 小时前
Java开发者还在被Python“碾压“？用Trae反击，让智能化应用开发快到飞起！
aigc·ai编程·trae
bug菌4 小时前
当AI遇上编程，传统IDE还能守住最后一道防线吗？Trae告诉你答案！
aigc·ai编程·trae
bug菌7 小时前
还在羡慕ChatGPT？用Trae零基础打造你的专属AI聊天机器人！
aigc·ai编程·trae
bug菌8 小时前
还在羡慕别人的IDE功能强大？看Trae插件系统如何让你的开发环境"私人定制"！
aigc·ai编程·trae
葫芦和十三8 小时前
解构 Coze Studio：AI Agent 连接万物的架构艺术
coze·mcp·trae
CF14年老兵9 小时前
Python万物皆对象：从懵懂到顿悟的奇妙之旅
后端·python·trae
热门推荐
01UV安装并设置国内源02Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code03【2025.08.06最新版】Android Studio下载、安装及配置记录（自动下载sdk）04KGG转MP3工具|非KGM文件|解密音频05TRAE 规则（Rules）配置指南：个人习惯、团队规范与最佳实践062025最新国内服务器可用docker源仓库地址大全（2025年8月更新）07NVIDIA显卡驱动、CUDA、cuDNN 和 TensorRT 版本匹配指南08蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接09阿里开源首个图像生成基础模型——Qwen-Image本地部署教程，超强中文渲染能力刷新SOTA！10TRAE Rules 实践：为项目配置 6A 工作流