内容
# Grok Blender MCP
一款 **Grok-first** 模型上下文协议（MCP）服务器，为 Grok 提供对 Blender 的原生控制。
用自然语言描述您想要的内容，然后观看 Grok 直接在 Blender 中构建、修改和迭代 3D 场景 - 通过视口截图提供实时视觉反馈。
## 功能
- **高级安全工具** - 创建基本形状、变换对象、应用材质、添加灯光、设置相机等。
- **实时视觉反馈** - `take_screenshot` 返回实际的视口图像，以便 Grok 可以看到它刚刚创建的内容。
- **强大的安全默认值** - 默认启用安全模式，每次更改自动撤销，Blender 中有紧急撤销按钮。
- **受保护的代码执行** - 具有 dry-run 模式和基本安全扫描的强大逃生通道。
- **Grok 优化** - 包括为 Grok 的优势而设计的精选提示策略和工作流程。
## 先决条件
- Blender 4.2+
- [Grok CLI](https://x.ai)（或任何兼容的 MCP 客户端）
- Python 3.10+
- `uv`（推荐）或 pip
## 安装
### 1. 安装 Blender 插件
1. 下载或克隆此存储库。
2. 在 Blender 中：**编辑 → 首选项 → 插件 → 安装...**
3. 选择 `blender-addon/addon.py`
4. 启用 **"Grok Blender MCP"**
### 2. 连接插件
1. 在 3D 视口中，按 **N** 打开侧栏。
2. 进入 **Grok Blender MCP** 选项卡。
3. 点击 **"连接到 Grok"** （默认情况下，它将在端口 9876 上监听）。
### 3. 将 MCP 服务器添加到 Grok
```bash
# 推荐：首先删除任何以前的损坏条目
grok mcp remove blender 2>/dev/null || true
# 使用本地安装进行添加
grok mcp add blender \
--command python \
--args -- -m grok_blender_mcp.server \
--env "PYTHONPATH=/absolute/path/to/grok-blender-mcp/src"
```
> **提示**：将 `/absolute/path/to/grok-blender-mcp` 替换为机器上的实际路径。
添加后，**完全重启** Grok CLI/TUI，然后通过以下命令验证：
```bash
grok mcp list
```
或在 Grok 中：`/mcps`
## 使用
连接后，您可以自然地与 Grok 交谈：
- "截取当前视口的截图"
- "在灰色平面上创建一个带有戏剧性光线的红色金属立方体"
- "构建一个简单的低多边形椅子"
- "使球体看起来像拉丝钢并显示结果"
Grok 将使用可用的工具，在需要时截取截图，并与您一起迭代。
## 项目结构
```
grok-blender-mcp/
├── blender-addon/
│ └── addon.py # 单文件 Blender 插件（易于安装）
├── src/grok_blender_mcp/
│ ├── server.py # 主要 MCP 服务器（FastMCP）
│ └── connection.py # 强大的 TCP 客户端到 Blender
├── docs/
│ └── SAFETY.md
├── pyproject.toml
└── README.md
```
## 安全
该工具赋予 AI 对 Blender 的重要控制权。我们构建了它，并配备了强大的安全措施：
- 安全模式（默认开启）
- 更改时的自动撤销
- Blender 中的紧急撤销按钮
- 原始代码执行的 dry-run 模式
详见 [docs/SAFETY.md](docs/SAFETY.md)。
## 开发
```bash
cd grok-blender-mcp
uv venv
source .venv/bin/activate
uv pip install -e .
uv run grok-blender-mcp
```
## 架构
```
Grok (CLI/TUI)
↔ MCP (stdio)
↔ Python 服务器 (FastMCP)
↔ TCP 套接字 (9876)
↔ Blender 插件 (bpy)
```
## 故障排除
**Grok 中显示“Blender MCP 不可用”，但 Blender 说它正在监听**
- 确保您在添加服务器后完全重启了 Grok。
- 手动测试服务器：
```bash
cd /path/to/grok-blender-mcp
source .venv/bin/activate
python -m grok_blender_mcp.server
```
- 检查您的 MCP 配置中的 `PYTHONPATH` 是否指向 `src` 文件夹。
**连接被拒绝**
- 确认插件正在运行并显示“监听端口 9876”。
- 通过在添加 MCP 时在环境中设置 `BLENDER_PORT` 来尝试使用不同的端口。
## 许可证
MIT
---
构建为自定义集成，以在 Blender 中为 Grok 提供一流的 3D 建模功能。
## 链接
- **存储库**：https://github.com/jaskirat1616/grok-blender-mcp
- **问题**：https://github.com/jaskirat1616/grok-blender-mcp/issues
---
*构建目的是为 Grok 提供对 Blender 的强大、安全和视觉感知的控制。*
