FastMCP GDMC Bridge
2025.05.11
0
PythonMinecraft 生成设计游戏自动化娱乐功能
FastMCP GDMC Bridge 是一个连接 FastMCP 和 GDPC 的桥梁，用于 Minecraft 的生成设计。它提供了一个 FastMCP 服务器，通过标准化的 API 暴露 GDPC（Generative Design Python Client）功能，使 AI 助手和其他应用程序能够通过 GDMC HTTP 接口与 Minecraft 世界进行交互。
View on GitHub
Overview
基本能力
产品定位
FastMCP GDMC Bridge 是一个用于 Minecraft 生成设计的工具，提供了一系列功能来与 Minecraft 世界进行交互。
核心功能
- 块放置：放置单个块或几何形状
- 地形分析：分析地形特征和高度图
- 结构构建：构建各种结构并进行变换
- 模型创建：创建和放置复杂模型
- 实体放置：在世界中生成实体
- 命令执行：运行 Minecraft 命令
- 世界信息：访问块、生物群系和玩家数据
适用场景
- 用于 AI 助手与 Minecraft 世界的交互
- 用于生成设计和自动化构建
- 用于地形分析和模型创建
工具列表
- place_block：在指定坐标放置块
- run_command：执行 Minecraft 命令
- place_cuboid：放置实心或空心立方体
- analyze_terrain：分析地形特征
- build_with_transform：构建结构并进行变换
- create_and_place_model：创建和放置复杂模型
- place_entities：在世界中放置实体
常见问题解答
无
使用教程
使用依赖
- Minecraft Java Edition 与 GDMC HTTP Interface mod (v1.6.0+)
- Python 3.8+
安装教程
# 克隆仓库
git clone https://github.com/natea/fastmcp-gdmc-bridge.git
cd fastmcp-gdmc-bridge
# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate
# 安装依赖
pip install -e .
调试方式
# 启动服务器（stdio 传输，适用于 AI 助手）
python -m gdmc_mcp.server
# 或启动服务器（SSE 传输，适用于 Web 应用程序）
fastmcp run gdmc_mcp.server --transport sse