Skip to main content
Glama

CDT-Blender

License: MIT Python 3.11 | 3.12 MCP Protocol Platform Tools

Blender-native MCP provider for bounded 3D execution. The bridge and addon own native operations; engineering-domain rules belong to CDT_Engineer.

CDT source candidate 0.2.3 (not yet published; MCP contract cdt-blender-contract-v10); upstream fork baseline 0.1.3 · 121 public tools. Verified native baseline: Blender 4.5.3 LTS on Windows 11. Other versions/platforms are unverified. Modeling/sculpt support is tool-specific; context acceptance is not complete modeling/sculpt certification.


Quickstart / MCP Client Configuration

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "cdt-blender": {
      "command": "uvx",
      "args": ["cdt-blender", "serve"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "cdt-blender": {
      "command": "uvx",
      "args": ["cdt-blender", "serve"]
    }
  }
}

Related MCP server: Blender MCP Link

Start

uv sync --group dev
uv run cdt-blender serve --host 127.0.0.1 --port 8008

Provision BLENDER_MCP_TOKEN through the deployment environment or secret manager before serving. In Blender, enable blender_mcp_addon and start its MCP server. Keep the addon socket local to the workstation.

The bridge exposes authenticated Streamable HTTP and unauthenticated health liveness. A healthy bridge does not prove the addon or required UI mode is ready.

On-Demand Workstation Execution (PC 171)

Theo quy định bắt buộc, máy trạm PC 171 không tự ý khởi động dịch vụ chạy ngầm. Khi AI Agent cần thao tác với Blender, Agent sẽ tự khởi động dịch vụ bằng script được cung cấp sẵn:

  • Windows Batch Script (CMD / PowerShell):

    scripts\start_service.bat [PORT] [TRANSPORT]
    :: Mặc định: PORT=8812, TRANSPORT=http
    scripts\start_service.bat 8812 http
  • Bash Shell Script (Git Bash / WSL / Remote SSH):

    ./scripts/start_service.sh [PORT] [TRANSPORT]
    # Ví dụ chạy HTTP trên cổng 8812:
    ./scripts/start_service.sh 8812 http

Kích hoạt từ xa qua SSH từ AI Agent:

ssh truon@192.168.1.171 "bash /mnt/pc-dev/CDT/CDT-Blender/scripts/start_service.sh 8812 http"

Lưu ý: Cần đảm bảo phần mềm Blender 4.x đang mở trên máy tính với addon blender_mcp_addon đang lắng nghe trên cổng nội bộ 8888.

Use

Call help, system_status and system_capabilities first. Verify the current application version, active object and mode for each operation. The runtime guide is the contract; pin its contract_hash. Reconcile uncertain mutation outcomes before retrying; timeout does not prove cancellation.

Attribution & License

MIT fork of seehiong/blender-mcp-bridge, pinned at b8113ae (v0.1.3). See LICENSE and ATTRIBUTION.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables remote control of Blender via the Model Context Protocol, allowing users to execute Python scripts, query scene data, and generate 3D models from images. It provides a bridge for AI clients to interact directly with Blender's internal environment and automate 3D content creation.
      3
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables interactive control of Blender for 3D scene manipulation, geometry creation, material application, and viewport rendering via natural language prompts through the Model Context Protocol.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI to control Blender 3D through the Model Context Protocol, allowing Python execution, scene state queries, and automation of 3D workflows.
      5
      GPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to control Blender 3D modeling and rendering through natural language commands via the Model Context Protocol.
      MIT