CDT-Blender
by SlncTrZ
README.md
# CDT-Blender
[](LICENSE)
[](pyproject.toml)
[](https://modelcontextprotocol.io)
[](docs/TOOL_GUIDE.md)
[](docs/TOOL_GUIDE.md)
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`)
```json
{
"mcpServers": {
"cdt-blender": {
"command": "uvx",
"args": ["cdt-blender", "serve"]
}
}
}
```
### Cursor (`~/.cursor/mcp.json`)
```json
{
"mcpServers": {
"cdt-blender": {
"command": "uvx",
"args": ["cdt-blender", "serve"]
}
}
}
```
---
## Start
```bash
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):**
```cmd
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):**
```bash
./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:
```bash
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.
- [Runtime tool contract](docs/TOOL_GUIDE.md).
- [Generated tool reference](docs/tools.md).
- [Gateway integration and operation](docs/SLNCTRZ_INTEGRATION.md).
- [Release, installation and rollback](docs/RELEASE_AND_DEPLOYMENT.md).
- [Contributor validation](tests/README.md).
- [Pinned shared specs](docs/SPEC_BASELINE.md).
- [Version tags, release artifacts and credential-safe deployment](docs/VERSIONING.md).
## Attribution & License
MIT fork of [seehiong/blender-mcp-bridge](https://github.com/seehiong/blender-mcp-bridge),
pinned at `b8113ae` (v0.1.3). See [LICENSE](LICENSE) and [ATTRIBUTION](ATTRIBUTION.md).
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues