VibeCraft MCP

VibeCaraft

人工智能驱动的Minecraft建筑 --通过与克劳德的自然语言对话构建结构。

运作原理

┌─────────────┐     MCP      ┌─────────────┐   WebSocket   ┌─────────────┐
│   Claude    │◄────────────►│  VibeCraft  │◄─────────────►│  Minecraft  │
│  (AI Chat)  │   Protocol   │ MCP Server  │    Bridge     │ Client Mod  │
└─────────────┘              └─────────────┘               └─────────────┘
                                                                  │
                                                                  ▼
                                                           ┌─────────────┐
                                                           │  Minecraft  │
                                                           │   Server    │
                                                           └─────────────┘

1. 你和克劳德聊天，让他做点什么
2. Claude向VibeCraft MCP服务器发送命令
3. 服务器通过WebSocket将命令转发到Fabric客户端模块
4. 客户端模组以玩家身份在Minecraft中执行命令

适用于任何Minecraft服务器 --香草、纸、Spigot或调制。WorldEdit可选。

______________________________________________________________________

快速开始

先决条件

• Python 3.10+ 随着 紫外线 包管理器
• Java 21 （适用于Minecraft 1.21.x）或 Java 17 （适用于1.20.x）
• jq 对于构建脚本： brew install jq
• Minecraft Java版 使用类似发射器的 棱镜

1.构建客户端模块

cd client-mod
./build.sh 1.21.1    # Replace with your Minecraft version

输出： build/release/vibecraft-client-0.1.0-mc1.21.1.jar

Supported versions

跑 ./build.sh --list 查看所有版本。

2.使用Prism Launcher进行安装

1. 创建实例： 添加实例→ 选择Minecraft版本→ OK
2. 添加织物： Edit → 版本→ 安装加载器→ 织物→ OK
3. 添加结构API： Mods → 下载mods→ 搜索“Fabric API”→ 选择→ OK
4. 添加VibeCaraft： Mods → 添加文件→ 选择 vibecraft-client-*.jar
5. 发射 加入世界/服务器

3.启用AI控制

在Minecraft聊天中：

/vibecraft allow

4.安装Python依赖项

cd mcp-server
uv sync

5.配置克劳德代码

添加到 ~/.claude.json:

{
  "projects": {
    "/path/to/vibecraft/agent": {
      "mcpServers": {
        "vibecraft": {
          "type": "sse",
          "url": "http://127.0.0.1:8765/sse"
        }
      }
    }
  }
}

6.启动MCP服务器

cd mcp-server
./start-vibecraft.sh

7.启动克劳德代码

cd agent
claude

你准备好了！让克劳德做点什么：

“给我建一座小石屋”

______________________________________________________________________

详细设置

看 docs/SETUP_GUIDE.md 用于：

• 替代启动器说明
• 标准模式配置
• 故障排除
• WorldEdit配置

______________________________________________________________________

配置

环境变量

世界编辑模式

• off --使用香草 /fill 和 /setblock 仅限命令
• auto --检测WorldEdit的可用性，回到vanilla
• force --需要WorldEdit，如果不可用，则失败

集 VIBECRAFT_WORLDEDIT_MODE=off 如果您没有安装WorldEdit。

客户端Mod命令

在Minecraft中运行这些：

______________________________________________________________________

用法

连接后，让克劳德构建东西：

User: "Build me a small cottage near my position"
Claude: "I see these players online: Steve, Alex. Which player should I build near?"
User: "Steve"
Claude: *builds cottage using /fill and /setblock commands*

从代理文件夹运行

为了获得最佳的建筑体验，请从 agent/ 文件夹：

cd agent
claude

此文件夹包含：

• 预配置 .mcp.json
• 培养技能和工作流程
• 材料指南和模板

______________________________________________________________________

故障排除

“未找到玩家”

确保你使用的是准确的玩家名称（区分大小写）。

“命令已发出”，但什么也没发生

客户端模块可能未捕获命令输出。更新到最新的mod版本。

“未知块类型”

该区块在您的Minecraft版本中不存在。使用版本中的块。

WorldEdit命令失败

集 VIBECRAFT_WORLDEDIT_MODE=off 如果您没有安装WorldEdit。

连接失败

1. 确保Minecraft正在使用mod运行
2. 跑 /vibecraft status 检查桥梁
3. 跑 /vibecraft allow 启用AI控制
4. 检查端口是否匹配（默认值：8766）

______________________________________________________________________

传统替代方案：仅服务器模式（RCON）

上面的客户端mod方法适用于任何服务器。对于 无头环境 或 服务器端自动化 如果没有Minecraft客户端，您可以直接使用RCON：

./setup-all.sh  # Starts Minecraft server in Docker with RCON

这对CI/CD测试很有用，但有局限性（没有多人游戏，需要服务器访问）。看 docs/CONFIGURATION.md 了解详情。

______________________________________________________________________

项目结构

vibecraft/
├── agent/                    # Run Claude here to BUILD in Minecraft
│   ├── .claude/skills/       # Building skills and workflows
│   ├── context/              # Material guides, templates
│   ├── .mcp.json             # MCP server config
│   └── CLAUDE.md             # Agent system prompt
│
├── client-mod/               # Fabric client mod (Java)
│   ├── src/                  # Mod source code
│   ├── build.gradle          # Gradle build config
│   └── README.md             # Mod-specific docs
│
├── mcp-server/               # MCP server (Python)
│   ├── src/vibecraft/        # Server source code
│   ├── server_http.py        # SSE mode entry point
│   ├── start-vibecraft.sh    # SSE mode launcher
│   └── pyproject.toml        # Python dependencies
│
└── README.md                 # This file

______________________________________________________________________

贡献

欢迎投稿！看 贡献.md.

许可证

MIT许可证-请参阅 许可证.

支持

• 📧 电子邮件： evan@amentilabs.com
• 🐛 问题：

明星历史

______________________________________________________________________

快乐建筑！ 🧱