内容
# BlenderMCP - Blender 模型上下文协议集成
BlenderMCP 通过模型上下文协议（MCP）将 Blender 连接到本地大型语言模型（LLMs），使运行在您自己的硬件上的助手能够自动化 Blender 工作流程。该集成提供了由 AI 引导的提示辅助 3D 建模、场景创建和操作，无需依赖云服务。
**我们没有官方网站。您在线看到的任何网站都是非官方的，与该项目无关。请自担风险使用它们。**
[快速链接](#架构与数据流) · [安装](#安装) · [使用](#使用) · [故障排除](#故障排除) · [贡献](#贡献)
[完整教程](https://www.youtube.com/watch?v=lCyQ717DuzQ)
### 加入社区
提供反馈、获取灵感并在此基础上构建 MCP：[Discord](https://discord.gg/z5apgR8TFU)
### 支持者
<div align="center" markdown="1">
<sup>特别感谢：</sup>
<br>
<br>
<a href="https://www.warp.dev/blender-mcp">
<img alt="Warp 赞助" width="400" src="https://github.com/user-attachments/assets/c21102f7-bab9-4344-a731-0cf6b341cab2">
</a>
### [Warp，适用于开发者的智能终端](https://www.warp.dev/blender-mcp)
[适用于 MacOS、Linux 和 Windows](https://www.warp.dev/blender-mcp)<br>
</div>
<hr>
**其他支持者：**
[CodeRabbit](https://www.coderabbit.ai/)
[Satish Goda](https://github.com/satishgoda)
**所有支持者：**
[支持该项目](https://github.com/sponsors/ahujasid)
## 版本说明（2.0.0）
- **模块化架构**：将大型处理程序从 `addon.py` 中分离出来，以提高稳定性和可维护性。
- **3D 打印工具包**：用于精确尺寸、打印厚度和自动床布局的新工具。
- **网格完整性**：通过 MCP 直接进行实时 manifold 检查和自动修复。
- **AmbientCG 集成**：搜索和下载数千种 PBR 材料。
- **产品工作室**：一键式专业照明、背景和产品渲染的相机设置。
- **车辆绑定**：自动为底盘和轮子创建基础绑定。
- **扩展模式支持**：与 Blender 4.2+ 扩展系统完全兼容。
## 功能
- **专业资产采购**：集成支持 Poly Haven、Sketchfab 和 AmbientCG。
- **精确 3D 打印**：精确的毫米级控制和自动导出工作流程。
- **网格健康检查**：3D 打印的完整性检查和自动 manifold 修復。
- **工作室自动化**：程序化工作室设置、照明主题和目录角度渲染。
- **双向通信**：通过基于套接字的 FastMCP 将本地 LLM 助手连接到 Blender。
- **对象操作**：创建、修改和删除具有空间意识的 3D 对象。
- **材质控制**：程序化材质节点生成和 PBR 纹理应用。
- **场景检查**：用于无碰撞对象放置的边界框感知场景数据。
- **视觉反馈**：用于助手视觉定位的实时视口截图。
- **代码执行**：安全控制的复杂自定义任务的 Python 执行。
## 组件
该系统由两个主要组件组成：
1. **Blender 插件（`addon.py`）**：一个 Blender 插件，在 Blender 中创建一个套接字服务器，以接收和执行命令
2. **MCP 服务器（`src/blender_mcp/server.py`）**：一个 Python 服务器，实现模型上下文协议并连接到 Blender 插件
## 架构与数据流
```mermaid
flowchart LR
subgraph MCP Client
A[MCP-aware client<br/>(LM Studio, Cursor, Continue)]
end
subgraph MCP Server
B[FastMCP server<br/>(`src/blender_mcp/server.py`)]
end
subgraph Blender
C[Addon socket server<br/>(`addon.py`)]
D[bpy / scene graph]
end
A -- MCP request/response --> B
B -- JSON over TCP --> C
C -- bpy API --> D
D -- results / viewport changes --> A
```
**交互总结**
- MCP 兼容的客户端调用 FastMCP 服务器公开的工具。服务器将工具调用作为 JSON 命令通过 TCP 中继到 Blender 插件，插件在 Blender 主线程上执行它们。
- Blender 场景更改（对象创建、材质编辑、导入）由插件的处理程序驱动，并作为结构化响应返回给 MCP 客户端。
**配置点**
- **套接字目标**：`BLENDER_HOST` 和 `BLENDER_PORT` 环境变量（默认为 `localhost:9876`）配置 MCP 服务器发送命令的位置。启动 Blender 内的插件时，必须使用相同的值。
- **插件面板**：Blender 侧边栏公开 Poly Haven 资产获取和连接控制等开关（参见 `addon.py` UI 操作符）。启用 Poly Haven 会更改助手可以调用的工具。
- **客户端启动**：MCP 客户端应通过 `uvx blender-mcp` 启动服务器（参见下面的 LM Studio/Continue/Cursor 部分）。一次应只有一个服务器实例处于活动状态，以避免端口冲突。
## 安装
### 先决条件
- Blender 3.0 或更新版本
- Python 3.10 或更新版本
- uv 包管理器：
**如果您是 Mac 用户，请使用以下命令安装 uv**
```bash
brew install uv
```
**在 Windows 上**
```bash
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
然后
```bash
set Path=C:\Users\nntra\.local\bin;%Path%
```
否则，请在他们的网站上查看安装说明：[安装 uv](https://docs.astral.sh/uv/getting-started/installation/)
**⚠️ 安装 UV 之前请勿继续**
### 环境变量
可以使用以下环境变量配置 Blender 连接：
- `BLENDER_HOST`：Blender 套接字服务器的主机地址（默认为 "localhost"）
- `BLENDER_PORT`：Blender 套接字服务器的端口号（默认为 9876）
您可以在启动时使用 CLI 标志覆盖这些环境变量，而不是使用环境变量：
```bash
uvx blender-mcp --host host.docker.internal --port 9876
```
### 日志配置
Blender MCP 现在从其入口点配置日志记录，允许您在从 MCP 客户端启动服务器时控制详细程度和目标：
- `BLENDER_MCP_LOG_LEVEL`：日志记录级别（例如 `DEBUG`、`INFO`、`WARNING`）。
- `BLENDER_MCP_LOG_FORMAT`：标准日志记录格式字符串（默认为时间戳/名称/级别/消息）。
- `BLENDER_MCP_LOG_HANDLER`：`console`（stderr）或 `file`。
- `BLENDER_MCP_LOG_FILE`：使用 `file` 处理程序时的文件路径（默认为 `blender_mcp.log`）。
工具调用现在返回结构化错误有效载体 (`{"error": {"code": "runtime_error", "message": "...", "data": {...}}}`)，而详细诊断继续写入配置的日志。
示例：
```bash
export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876
uvx blender-mcp --log-level debug --log-format "%(levelname)s:%(message)s"
```
### 图形界面（PySide6）
安装额外的 `gui` 以启用界面：
```bash
uv pip install '.[gui]'
```
然后，执行：
```bash
uv run blender-mcp-gui
```
窗口列出并允许编辑服务器使用的所有环境变量（Blender 主机/端口和日志记录选项），立即应用更改并重新配置日志，而无需手动编辑文件。
> Windows/PowerShell 的提示：使用 `py -m pip install uv`（或 `python -m pip install uv`）安装 `uv`，然后将 `uv.exe` 可执行文件放入 Python 脚本目录（通常为 `%APPDATA%\Python\Scripts` 或 `%USERPROFILE%\.local\bin`）；如果 PowerShell 找不到 `uv`，请将此路径添加到 `PATH` 环境变量中。
### LM Studio 集成
LM Studio（v0.3.0 或更新版本）配备了原生的 MCP 客户端支持，允许任何本地托管的模型直接调用 Blender 工具。
1. 安装 [LM Studio](https://lmstudio.ai/) 并下载要运行的模型。
2. 打开 **设置 → 开发者 → 模型上下文协议（MCP）**。
3. 点击 **添加 MCP 服务器** 并配置为：
- **命令：** `uvx`
- **参数：** `blender-mcp`
4. 保存配置并启动与模型的聊天。服务器运行后，将出现一个新的 **Blender MCP** 工具托盘。
如果您更喜欢手动编辑 JSON 配置文件，请创建或更新 LM Studio MCP 配置文件（位于 `~/Library/Application Support/LM Studio/mcpServers.json` 在 macOS 上，`%APPDATA%/LM Studio/mcpServers.json` 在 Windows 上，或 `~/.config/LM Studio/mcpServers.json` 在 Linux 上）为：
```json
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"],
"env": {}
}
}
}
```
重启 LM Studio 以加载服务器定义。
### Ollama 集成
Ollama 提供模型运行时，而像 [Continue](https://continue.dev/) 或 [Open WebUI](https://github.com/open-webui/open-webui) 这样的 MCP 感知客户端协调对话。典型的设置如下：
1. 安装 [Ollama](https://ollama.com/) 并运行 `ollama pull llama3`（或您喜欢的任何其他模型）。
2. 为 VS Code 安装 Continue 扩展或 Continue 桌面客户端，并选择 **Ollama** 作为您的助手提供商。
3. 在 Continue 的设置（`continue.json`）中，注册 Blender MCP 服务器：
```jsonc
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}
```
4. 启动 Continue 会话，确保 Ollama 正在运行，并请求助手使用 Blender MCP 工具。您可以在任何与 Ollama 兼容的 MCP 客户端上重用相同的配置。
### Cursor 集成
[](https://cursor.com/install-mcp?name=blender&config=eyJjb21tYW5kIjoidXZ4IGJsZW5kZXItbWNwIn0%3D)
对于 Mac 用户，请转到设置 > MCP 并粘贴以下内容
- 使用全局服务器，请使用“添加新的全局 MCP 服务器”按钮并粘贴
- 使用项目特定服务器，请在项目根目录中创建 `.cursor/mcp.json` 并粘贴
```json
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}
```
对于 Windows 用户，请转到设置 > MCP > 添加服务器，并添加具有以下设置的服务器：
```json
{
"mcpServers": {
"blender": {
"command": "cmd",
"args": [
"/c",
"uvx",
"blender-mcp"
]
}
}
}
```
[Cursor 设置视频](https://www.youtube.com/watch?v=wgWsJshecac)
**⚠️ 在您选择的 MCP 客户端中，一次只能运行一个 MCP 服务器实例**
### Visual Studio Code 集成
_先决条件：确保您已安装 [Visual Studio Code](https://code.visualstudio.com/)_
[](vscode:mcp/install?%7B%22name%22%3A%22blender-mcp%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22blender-mcp%22%5D%7D)
### 安装 Blender 扩展
1. 在 GitHub Releases 中，下载 Blender 扩展资产（例如：`blender-mcp-extension-v1.3.1.zip`）。不要使用自动“源代码（zip）”文件。
1. 打开 Blender
2. 转到编辑 > 首选项 > 扩展
3. 点击下拉菜单并选择“从磁盘安装...”
4. 选择扩展 `.zip` 并启用“Blender MCP”
扩展包包括 `blender_manifest.toml` 和 `__init__.py`，这是 Blender 扩展程序的要求。
## 使用
### 启动连接
1. 在 Blender 中，转到 3D 视图侧边栏（按 N 如果不可见）
2. 找到“BlenderMCP”选项卡
3. 如果您想从 Poly Haven 的 API 获取资产，请启用 Poly Haven 复选框（可选）
4. 点击“连接到 LLM 客户端”
5. 确保您的 MCP 客户端已启动 `blender-mcp` 服务器（如果需要，您也可以手动启动它，例如 `uvx blender-mcp`）
您还可以使用 BlenderMCP 面板中的 **本地设置** 按钮：
- **检查/安装依赖项**：在项目根目录运行 `uv sync --extra gui --extra test`。
- **在终端中运行 MCP 服务器**：启动 `uv run blender-mcp --host localhost --port <panel-port>` 进入新终端。
- **复制 MCP 客户端配置**：复制一个准备好的 stdio 配置片段（Claude Desktop、Cursor、Ollama 兼容的 MCP 客户端、LM Studio）到您的剪贴板。
- **健康检查**：运行 `uv run blender-mcp --doctor --host localhost --port <panel-port>` 并在 Blender 控制台中打印诊断信息。
- **打开日志**：打开活动 `blender_mcp.log` 文件（或 `BLENDER_MCP_LOG_FILE`）在 OS 默认应用程序中。
### MCP 配置片段（Claude Desktop + LM Studio）
使用这些片段配置 MCP 的 `stdio`。替换 `localhost` 和 `9876`，如果您的 Blender 插件正在其他地方监听。
Claude Desktop (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"blender": {
"command": "uv",
"args": ["run", "blender-mcp", "--host", "localhost", "--port", "9876"]
}
}
}
```
LM Studio (`mcpServers.json`):
```json
{
"mcpServers": {
"blender": {
"command": "uv",
"args": ["run", "blender-mcp", "--host", "localhost", "--port", "9876"]
}
}
}
```
快速诊断连接前：
```bash
uv run blender-mcp --doctor --host localhost --port 9876
```
### 完整使用流程
使用以下步骤第一次将所有内容上线或在设置中断时进行故障排除。目标是确保 Blender、MCP 服务器和您选择的客户端都正确指向彼此。
1. **准备 Blender 和插件**
- 安装并启用 Blender MCP（参见 [安装 Blender 扩展](#installing-the-blender-extension））。
- 打开 **BlenderMCP** 选项卡并保持面板可见，以便您读取连接状态更新。
2. **验证主机/端口对齐**
- 在 Blender 面板中，检查主机和端口字段。它们默认为 `localhost` 和 `9876`。
- 如果您需要 Blender 接受来自另一台机器或容器的连接，请使用环境变量 `BLENDER_HOST` 和 `BLENDER_PORT` 在启动 MCP 服务器之前设置匹配的值（参见 [环境变量](#environment-variables）。
3. **启动 MCP 服务器**
- 让您的 MCP 感知客户端（LM Studio、Continue、Cursor、VS Code 等）自动启动服务器 **或** 在终端中自己启动它：
```bash
uvx blender-mcp
```
- 保持终端窗口打开；服务器日志将报告连接尝试和工具调用。
4. **连接到 Blender**
- 在 Blender 中，点击 **连接到 LLM 客户端**。面板中的状态消息应在几秒后更改为已连接。
- 如果失败，请确认没有其他 `blender-mcp` 服务器实例已经运行，并且防火墙允许 TCP 上选择的端口。
5. **测试往返通信**
- 在您的 MCP 客户端，询问助手以“列出场景中的所有对象”。
- Blender 应该在聊天中响应对象数据，确认端到端路径：MCP 客户端 → MCP 服务器 → Blender 插件 → 返回客户端。
6. **保持在一个运行的服务器**
- 每个机器上应该只有一个 MCP 服务器实例。如果您切换客户端，请先停止前面的服务器以避免端口冲突。
### 日常使用的实用提示
- **保持 Blender 打开**：插件在 Blender 的主线程上处理命令，因此在工作时 Blender 窗口必须保持打开。
- **经常保存**：工具调用可能会执行破坏性操作（例如，大量删除）。保存版本或启用自动保存以保护正在进行的工作。
- **优先使用小而明确的请求**：将复杂提示分解为步骤，例如“创建房间布局”→“添加照明”→“应用材质”→“渲染图像”以获得可预测的结果。
- **检查工具调用**：大多数 MCP 客户端会显示工具调用日志。使用它来了解助手正在向 Blender 发送的内容，并复制/调整命令。
- **从脚本运行**：您可以从自己的自动化脚本（shell 脚本、Makefiles、CI）调用 `uvx blender-mcp`，只要 Blender 正在运行并且插件已启用。
### 与本地 LLM 客户端一起使用
在您的 MCP 客户端（LM Studio、Continue、Cursor 等）配置并运行内部 Blender 插件后，助手将公开一个带有 Blender MCP 工具的锤子图标。
#### 能力
- 获取场景和对象信息
- 创建、删除和修改形状
- 为对象应用或创建材质
- 在 Blender 中执行任何 Python 代码
- 通过 [Poly Haven](https://polyhaven.com/) 下载合适的模型、资产和 HDRIs
### 示例命令
以下是您可以要求本地助手执行的操作示例：
- “创建一个地下城的低多边形场景，带有一个守护金币的龙” [Demo](https://www.youtube.com/watch?v=DqgKuLYUv00)
- “使用 HDRIs、纹理和 Poly Haven 中的岩石和植被等模型创建一个海滩氛围” [Demo](https://www.youtube.com/watch?v=I29rn92gkC4)
- 提供参考图像，从中创建一个 Blender 场景 [Demo](https://www.youtube.com/watch?v=FDRb03XPiRo)
- “获取当前场景的信息，并从中创建一个 threejs 草图” [Demo](https://www.youtube.com/watch?v=jxbNI5L7AH8)
- “把这辆车变成红色和金属色”
- “创建一个球体并将其放在立方体上方”
- “让灯光像工作室一样”
- “将相机指向场景，并使其呈等距投影”
### 安全注意事项
```bash
# Linux/Mac
# Windows PowerShell
# Windows CMD
```
如果未设置，插件不会自动填充免费试用密钥。
## 故障排除
### 常见问题和解决方案
#### 连接被拒绝 / 无法连接到 Blender
**症状**：出现诸如“连接被拒绝”、“无法建立连接”或超时错误等错误消息。
**解决方案**：
1. **验证插件是否运行中**：
- 打开 Blender
- 进入 3D 视图侧栏（按 `N`）
- 找到 "BlenderMCP" 标签页
- 检查状态是否显示“已连接”或“服务器运行中”
- 如果不是，请点击“连接到 LLM 客户端”
2. **检查端口和主机是否匹配**：
- 插件默认使用 `localhost:9876`
- 检查环境变量 `BLENDER_HOST` 和 `BLENDER_PORT`
- 确保 MCP 服务器配置与插件设置匹配
3. **防火墙阻止**：
- 检查防火墙是否阻止了端口 9876
- 在 Linux 上：`sudo ufw allow 9876/tcp`
- 在 Windows 上：在 Windows Defender 防火墙中添加例外
- 在 Mac 上：系统偏好设置 > 安全与隐私 > 防火墙 > 防火墙选项
4. **端口已被占用**：
- 每次只能运行一个 MCP 服务器实例
- 杀死任何现有的进程：`lsof -ti:9876 | xargs kill -9`（Linux/Mac）
- 在 Windows 上：`netstat -ano | findstr :9876` 然后任务杀死
#### MCP 服务器无法启动
**症状**：`uvx blender-mcp` 失败或 MCP 客户端显示服务器不可用。
**解决方案**：
1. **uv 未安装**：
```bash
# Mac
brew install uv
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
set Path=C:\Users\<username>\.local\bin;%Path%
# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
```
2. **Python 版本不匹配**：
- 需要 Python 3.10+
- 检查：`python --version`
- 从 [python.org](https://www.python.org/downloads/) 安装
3. **依赖问题**：
```bash
# 强制重新安装
uvx --force blender-mcp
```
#### 超时错误 / “Blender 没有响应”
**症状**：操作超时、响应不完整或“Blender 在 N 次尝试后没有响应”。
**解决方案**：
1. **增加超时值**：
```bash
export BLENDER_SOCKET_TIMEOUT=30
export BLENDER_CONNECT_ATTEMPTS=5
export BLENDER_COMMAND_ATTEMPTS=5
```
2. **复杂操作**：
- 将请求分解为较小步骤
- 对于 Poly Haven/Sketchfab 下载，较大文件需要更多时间
3. **Blender 忙**：
- 确保 Blender 窗口响应正常
- 关闭其他繁重的 Blender 操作
- 在进行大型操作前保存工作
#### PolyHaven 集成无法使用
**症状**：“PolyHaven 集成已禁用”或资产无法下载。
**解决方案**：
1. **在 Blender 中启用**：
- 在侧栏打开 BlenderMCP 标签页
- 勾选“Poly Haven”复选框
- 状态应显示“已启用”
2. **网络问题**：
- 检查互联网连接
- 验证访问 https://api.polyhaven.com
- 如果在企业防火墙后面，请检查代理设置
3. **提醒助手**：
- 有时 AI 会忘记
- 告诉它：“首先检查 PolyHaven 状态”或“在 Blender 中启用 PolyHaven 复选框”
#### 其他问题
**症状**：“余额不足”，生成错误，或生成过程中超时。
**解决方案**：
1. **免费试用限制**：
- 免费试用密钥有每日限制
- 如果超出限制，您必须：
- 等待下一天（在 UTC 时间凌晨重置）
2. **检查 API 模式**：
- 插件支持两种模式：MAIN_SITE 和 FAL_AI
- 检查在 Blender 中配置了哪种模式
- 使用适当的参数（路径 vs. 图片 URL）
3. **轮询 vs. 等待**：
- 不要同步等待生成
- 创建作业 → 轮询状态 → 完成后导入
- 生成可能需要几分钟
#### 导入错误 / 模块未找到
**症状**：`ImportError`、`ModuleNotFoundError` 或缺少依赖。
**解决方案**：
1. **安装额外依赖**：
```bash
# For GUI
uvx blender-mcp --with PySide6
# 或在虚拟环境中安装
uv pip install 'blender-mcp[gui]'
```
2. **检查 Python 路径**：
- 确保 `uvx` 使用正确的 Python
- 检查：`uvx --python 3.11 blender-mcp`
3. **重新安装**：
```bash
uv cache clean
uvx --force --reinstall blender-mcp
```
#### 平台特定问题
**Windows**：
- PowerShell 执行策略：`Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned`
- 路径分隔符：使用正斜杠 `/` 或转义的反斜杠 `\\`
- 长路径：启用 [长路径支持](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation)
**Mac**：
- Gatekeeper 阻止：右键 > 打开以运行
- 权限：授予 Blender 网络权限时提示
- Apple Silicon：确保 ARM64 Python 版本
**Linux**：
- AppImage Blender：可能有隔离环境
- Snap Blender：检查隔离权限
- Flatpak Blender：使用 `--socket` 权限
### 高级故障排除
#### 验证烟雾测试
使用以下命令逐步验证关键路径：
```bash
# 真实的 Blender + 插件套接字烟雾测试（Windows 默认路径：C:\Blender\blender.exe）
pytest tests/test_e2e_addon_server.py -q
# MCP 服务器诊断单元测试
pytest tests/test_server.py -q
# GUI 验证测试（需要 PySide6）
pytest tests/test_gui.py -q
# 视觉回归测试（需要 PySide6 + 基线图像）
pytest tests/visual/test_gui_visual_regression.py -q
```
创建/更新视觉基线：
```bash
set BLENDER_MCP_UPDATE_BASELINE=1
pytest tests/visual/test_gui_visual_regression.py -q
set BLENDER_MCP_UPDATE_BASELINE=
```
#### 启用调试日志
```bash
export BLENDER_MCP_LOG_LEVEL=DEBUG
export BLENDER_MCP_LOG_HANDLER=file
uvx blender-mcp
```
检查 `blender_mcp.log` 以获取详细诊断信息。
#### 手动测试连接
启动一个模拟服务器来测试连接：
```python
import socket, json
sock = socket.socket()
sock.bind(('localhost', 9876))
sock.listen(1)
print("监听 localhost:9876")
conn, addr = sock.accept()
print(f"已连接：{addr}")
while True:
data = conn.recv(8192)
if not data: break
print(f"收到：{data.decode()}")
response = json.dumps({"status": "ok", "result": {}})
conn.sendall(response.encode())
```
然后从 MCP 客户端进行测试。
#### 检查插件控制台
在 Blender 中：
- 窗口 > 切换系统控制台（Windows）
- 查看控制台输出的错误消息
- 检查套接字绑定错误或异常
### 获取帮助
如果问题仍然存在：
1. 检查 [GitHub 问题](https://github.com/modelcontextprotocol/blender-mcp/issues)
2. 加入 [Discord 社区](https://discord.gg/z5apgR8TFU)
3. 在错误报告中包含：
- 操作系统和版本
- Blender 版本
- Python 版本
- 完整的错误消息
- 重现步骤
- 日志（使用 `--log-level DEBUG`）
### 已知限制
- **连接问题**：第一个命令有时会失败，随后的命令会成功
- **复杂操作**：可能需要分解为较小步骤
- **Poly Haven**：需要启用复选框；助手可能会忘记
- **execute_blender_code**：功能强大但危险 - 始终先保存
- **截图质量**：受视口大小和设置限制
## 技术细节
### 通信协议
系统使用基于 TCP 套接字的简单 JSON 协议：
- **命令** 作为包含 `type` 和可选 `params` 的 JSON 对象发送
- **响应** 作为包含 `status` 和 `result` 或 `message` 的 JSON 对象
## 限制和安全考虑
- `execute_blender_code` 工具允许在 Blender 中运行任意 Python 代码，这可能很强大但也存在潜在危险。在生产环境中使用时请谨慎。 **始终先保存工作**。
- Poly Haven 需要下载模型、纹理和 HDRI 图片。如果您不想使用它，请在 Blender 中的复选框中关闭它。
- 复杂操作可能需要分解为较小步骤
## 贡献
欢迎贡献！请随时提交拉取请求。
## 免责声明
这是第三方集成，非 Blender 官方制作。由 [Siddharth](https://x.com/sidahuj) 制作。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器