Minecraft Builder Claude MCP Server

Minecraft Builder MCP服务器

一个MCP（模型上下文协议）服务器，使Claude能够从自然语言描述中生成Minecraft结构。描述你想要构建什么，克劳德将创建一个 .schem 您可以导入Minecraft的文件。

特性

• 自然语言到Minecraft结构转换
• Claude Desktop和Claude Code的MCP集成
• 兼容WorldEdit .schem 文件生成
• 在Windows资源管理器中自动打开文件夹
• 支持从简单平台到复杂建筑的结构
• 无API费用-与您的Claude订阅一起使用

安装

先决条件

• Python 3.10或更高版本
• 克劳德桌面或克劳德代码

设置

1. 克隆或下载此存储库

1. 安装依赖项：

   pip install -r requirements.txt

1. 安装软件包：

   pip install -e .

1. 配置克劳德桌面或克劳德代码：

编辑您的配置文件：

- 视窗: %APPDATA%\Claude\claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

添加此配置：

   {
     "mcpServers": {
       "minecraft-builder": {
         "command": "python",
         "args": ["-m", "minecraft_builder"]
       }
     }
   }

1. 完全重新启动Claude桌面/代码

用法

安装后，与Claude聊天并描述结构。克劳德会问文件保存在哪里。

简单的例子

Create a 5x5 stone platform

Build a wooden door frame using oak planks

Make a campfire area with logs arranged in a circle

复杂示例

Build a medieval cottage: 8x6 blocks, oak planks walls, stone foundation, glass windows, 6 blocks tall

Create a lighthouse tower with a circular stone base (7 blocks diameter), 25 blocks tall, stone for bottom 20 blocks, glass for top 5 blocks

Design a garden with a cobblestone path down the middle (10 blocks long), dirt blocks on sides for planting

看 examples/PROMPTS.md 有关更详细的示例和提示。

运作原理

1. 你向克劳德描述一个结构
2. Claude生成带有块坐标的JSON定义
3. Claude询问在哪里保存.schema文件
4. 该工具将JSON转换为Sponge Schematic v2格式
5. Claude可以在Windows资源管理器中打开该文件夹

可用工具

create_minecraft_structure -将结构定义转换为.schema文件

• 支持中小型结构的直接JSON输入
• 支持大型结构的基于文件的输入（请参阅large_STRUCTURE_GUIDE.md）

openfolder_inexplorer -在输出位置打开Windows资源管理器

• 可以突出显示创建的文件

导入Minecraft

生成的 .schem 文件使用 创世神:

1. 复制 .schem 将文件保存到WorldEdit原理图文件夹：

- 服务器： [world]/plugins/WorldEdit/schematics/ - 客户（锻造/织物）： .minecraft/config/worldedit/schematics/

1. 在游戏命令中：

   //schem load 
   //paste

或者，使用 MCEdit, 护身符编辑或其他示意图工具。

JSON结构格式

该工具接受以下格式的结构：

{
  "name": "my_structure",
  "description": "Optional description",
  "blocks": [
    {
      "x": 0,
      "y": 0,
      "z": 0,
      "block_type": "minecraft:stone"
    },
    {
      "x": 1,
      "y": 0,
      "z": 0,
      "block_type": "oak_planks"
    }
  ]
}

块ID：

• 完整格式： minecraft:stone, minecraft:oak_planks
• 简短格式： stone, oak_planks （自动前缀为 minecraft:)

协调：

• 原点：（0，0，0）
• X： 宽度，Y：高度，Z：长度
• 所有相对于结构原点的坐标

兼容性

• 原理图格式：Sponge原理图v2
• Minecraft版本：1.13+（1.19.4目标）
• 导入需要WorldEdit 7.x

项目结构

llm-minecraft-builds/
├── src/minecraft_builder/
│   ├── __init__.py
│   ├── __main__.py       # MCP server entry point
│   ├── server.py          # MCP server and tool definitions
│   ├── schema.py          # Pydantic data models
│   └── converter.py       # JSON to .schem converter
├── examples/
│   ├── example_structures.json
│   └── PROMPTS.md
├── requirements.txt
├── pyproject.toml
├── README.md
├── CLAUDE.md              # Instructions for Claude Code
└── LARGE_STRUCTURE_GUIDE.md

故障排除

MCP服务器未出现：

• 完全重新启动克劳德桌面
• 验证配置文件位置和语法
• 检查Python是否可访问： python --version
• 确保软件包已安装： pip list | grep minecraft-builder

安装错误：

• 使用Python 3.10或更高版本
• 安装所有依赖项： pip install -r requirements.txt
• 尝试： pip install -e . --force-reinstall

结构无法导入Minecraft：

• 验证.schema文件是否已创建
• 检查是否安装了WorldEdit（7.x+版本）
• 确认Minecraft版本为1.13或更高版本
• 使用 //schem list 在游戏中验证是否检测到文件

截断的大型结构：

• 看 LARGE_STRUCTURE_GUIDE.md 用于处理复杂结构
• 对于300多个块，让Claude先将JSON写入文件

路径问题（WSL）：

• 提供Windows路径： C:\Users\username\Desktop
• 避开WSL路径： /mnt/c/Users/...

发展

在本地运行

cd src
python -m minecraft_builder

服务器以stdio模式运行，用于MCP通信。

测试

python test_converter.py

依赖项

• 主控程序 （>=0.9.0）-MCP Python SDK
• mcschematic （>=11.0.0）-Minecraft原理图文件处理
• 皮丹提克 （>=2.0.0）-数据验证

贡献

欢迎捐款：

• 其他输出格式（.nbt、.litematic）
• 块状态和NBT数据支持
• 增强结构验证
• 更多示例结构

许可证

MIT许可证

鸣谢

构建使用：

• MCP（模型上下文协议） 通过Anthropic
• mcschematic 用于原理图文件处理
• 派丹蒂克 用于数据验证