Blender Open MCP

搅拌机打开mcp

使用Olama的Blender3D开放式MCP模型

通过本地AI模型使用自然语言提示控制Blender 3D。建立在 模型上下文协议（MCP），通过本地Ollama LLM将Claude、Cursor或任何MCP客户端连接到Blender。

______________________________________________________________________

建筑

MCP Client (Claude/Cursor/CLI)
         │ HTTP / stdio
         ▼
┌─────────────────────┐
│   FastMCP Server    │  ← server.py  (port 8000)
│   blender-open-mcp  │
└─────────────────────┘
    │ TCP socket           │ HTTP
    ▼                      ▼
┌──────────────┐    ┌─────────────┐
│  Blender     │    │   Ollama    │  (port 11434)
│  Add-on      │    │  llama3.2   │
│  addon.py    │    │  gemma3...  │
│  (port 9876) │    └─────────────┘
└──────────────┘
       │ bpy
       ▼
  Blender Python API

三个独立的过程：

• FastMCP服务器 (server.py)：通过HTTP或stdio公开MCP工具
• 搅拌机插件 (addon.py)：Blender内部运行的TCP套接字服务器
• 奥拉玛：本地LLM服务于自然语言查询

______________________________________________________________________

安装

先决条件

1.克隆和设置

git clone https://github.com/dhakalnirajan/blender-open-mcp.git
cd blender-open-mcp

# Create virtual environment and install
uv venv
source .venv/bin/activate   # Linux / macOS
# .venv\Scripts\activate    # Windows

uv pip install -e .

2.安装搅拌机插件

1. 打开搅拌机
2. 首选 Edit → 偏好→ 附加组件→ 安装。..
3. 选择 addon.py 从存储库根目录
4. 启用 “搅拌机MCP”
5. 打开 三维视口，按 N，找到 搅拌机MCP 面板
6. 点击 “启动MCP服务器” （默认端口：9876）

3.拉一个Olama模型

ollama pull ollama run llama3.2

*（其他型号如 Gemma3 也可以使用。)*

设置

1. 启动Ollama服务器： 确保Ollama在后台运行。

1. 启动MCP服务器：

blender-mcp

自定义选项：

blender-mcp \
  --host 127.0.0.1 \
  --port 8000 \
  --blender-host localhost \
  --blender-port 9876 \
  --ollama-url http://localhost:11434 \
  --ollama-model llama3.2

对于stdio传输（克劳德桌面、光标）：

blender-mcp --transport stdio

______________________________________________________________________

用法

MCP客户端CLI

# Interactive shell
blender-mcp-client interactive

# One-shot scene info
blender-mcp-client scene

# Call a specific tool
blender-mcp-client tool blender_get_scene_info
blender-mcp-client tool blender_create_object '{"primitive_type": "SPHERE", "name": "MySphere"}'

# Natural language prompt
blender-mcp-client prompt "Create a metallic sphere at position 0, 0, 2"

# List all available tools
blender-mcp-client tools

Python API

import asyncio
from client.client import BlenderMCPClient

async def demo():
    async with BlenderMCPClient("http://localhost:8000") as client:
        # Scene inspection
        print(await client.get_scene_info())

        # Create objects
        await client.create_object("CUBE", name="MyCube", location=(0, 0, 0))
        await client.create_object("SPHERE", name="MySphere", location=(3, 0, 0))

        # Apply materials
        await client.set_material("MyCube", "GoldMat", color=[1.0, 0.84, 0.0, 1.0])

        # Move objects
        await client.modify_object("MySphere", location=(3, 0, 2), scale=(1.5, 1.5, 1.5))

        # PolyHaven assets
        categories = await client.get_polyhaven_categories("textures")
        await client.download_polyhaven_asset("brick_wall_001", resolution="2k")
        await client.set_texture("MyCube", "brick_wall_001")

        # Render
        await client.render_image("/tmp/my_render.png")

        # AI assistance
        response = await client.ai_prompt(
            "Write bpy code to add a sun light pointing down"
        )
        print(response)

        # Execute the generated code
        await client.execute_code(response)

asyncio.run(demo())

Claude桌面/光标集成

添加到您的 mcp.json （或 ~/.cursor/mcp.json):

{
  "mcpServers": {
    "blender-open-mcp": {
      "command": "blender-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

______________________________________________________________________

可用工具

______________________________________________________________________

默认端口

______________________________________________________________________

发展

# Install dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Type checking
mypy src/

# Linting
ruff check src/ client/

______________________________________________________________________

故障排除

______________________________________________________________________

许可证

MIT许可证。看 许可证 了解详情。

该项目不隶属于Blender基金会。