Blender add-on and MCP server that let AI assistants like Claude build, modify and inspect 3D scenes in Blender through prompts.
sixtysevenlf/dsh-blender-plugin
A DSH plugin that lets an AI model drive a running Blender session over a direct TCP channel, exposing 16 tools for viewport capture, scene edits and headless work.
- Stars
- 886
- Forks
- 33
- Open issues
- 10
- Last commit
- 21 hours ago
What is it?
DSH x Blender is a plugin for the DSH (DeepSeek Harness) agent environment that connects an AI model directly to Blender over a local TCP channel, without an MCP server. A bundled Blender addon listens on 127.0.0.1:9876 and a Node.js backend on 127.0.0.1:9877 relays commands, so the model can capture the 3D viewport, execute Python on Blender's main thread, render from custom camera angles, and run iterative parameter searches.
Beyond live scene editing, the plugin covers render performance profiling with preset settings, safe object decimation, headless `blender -b` processes for heavy renders and batch geometry, transactions with snapshot or object-level rollback, a reusable preset library, and a job layer for long-running work. A plan tool groups contract checks, mesh audits, assembly gates and export verification into 28 families and 186 operations.
The plugin requires Blender 4.x or 5.x running with its GUI for the live channel, Node.js 20 or later, and a DSH installation. It supports WSL with Windows Blender, Windows, native Linux and macOS, and it is released under the BSD-3-Clause license.
Key features
- 01Captures the 3D viewport from the user's view or from any custom camera angle without changing the scene.
- 02Runs Python on Blender's main thread through a persistent kernel for multi-step edits.
- 03Runs iterative parameter search loops inside Blender with iteration and time caps.
- 04Profiles render settings and applies persistent-data and denoiser presets, with revert support.
- 05Offloads heavy renders and batch geometry to headless Blender processes.
- 06Provides snapshot and object-level transactions for rollback.
Use cases
- Letting an AI agent model, adjust and verify objects in an open Blender scene.
- Running parameter sweeps that fit a model to a reference silhouette.
- Batch rendering or geometry processing in headless Blender while the GUI stays free.
- Checking mechanical assemblies for clearance and interference before 3D printing.
Quick start
- 1
Clone the repo and enter the directory
cd dsh-blender-plugin - 2
Install it into a DSH profile as a bundle (symlink, then add the link to the profile package.json, then restart DSH)
- 3
Start Blender, connect the bundled DSH Blender Bridge addon, then check the install with the doctor endpoint
curl -sS http://127.0.0.1:9877/doctor
Things to know
- Requires Blender running in GUI mode, since the live channel does not work with background mode.
- Requires a DeepSeek Harness (DSH) host and Node.js 20 or newer.
- The upstream MCP for Blender addon is no longer supported; you must install the bundled addon instead.
Topics
FAQ
- What is dsh-blender-plugin?
- A DSH plugin that lets an AI model drive a running Blender session over a direct TCP channel, exposing 16 tools for viewport capture, scene edits and headless work. DSH x Blender is a plugin for the DSH (DeepSeek Harness) agent environment that connects an AI model directly to Blender over a local TCP channel, without an MCP server. A bundled Blender addon listens on 127.0.0.1:9876 and a Node.js backend on 127.0.0.1:9877 relays commands, so the model can capture the 3D viewport, execute Python on Blender's main thread, render from custom camera angles, and run iterative parameter searches.
- Is dsh-blender-plugin free to use? What license does it have?
- dsh-blender-plugin is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.
- Is dsh-blender-plugin still maintained?
- Actively maintained. The last commit to dsh-blender-plugin was on Oct 19, 2026.
- What can I use dsh-blender-plugin for?
- Letting an AI agent model, adjust and verify objects in an open Blender scene. Running parameter sweeps that fit a model to a reference silhouette. Batch rendering or geometry processing in headless Blender while the GUI stays free. Checking mechanical assemblies for clearance and interference before 3D printing.
- How do I install dsh-blender-plugin?
- Clone the repo and enter the directory: cd dsh-blender-plugin Install it into a DSH profile as a bundle (symlink, then add the link to the profile package.json, then restart DSH) Start Blender, connect the bundled DSH Blender Bridge addon, then check the install with the doctor endpoint: curl -sS http://127.0.0.1:9877/doctor
- Where can I get dsh-blender-plugin?
- The source code and installation instructions are on GitHub: https://github.com/sixtysevenlf/dsh-blender-plugin
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An AI agent that controls Windows at the GUI level by reading the UI Automation tree and letting any LLM choose clicks, typing and commands.
A curated, community-maintained list of plugins for DeepSeek Harness (dsh), a coding agent built on a plugin-based framework.
An AI agent skill that drives the desktop JianYing (Chinese CapCut) Pro to automate video editing from natural-language instructions.
GitHub's official MCP server that lets AI assistants read repositories, manage issues and pull requests, and work with GitHub Actions.
A DSH plugin that renders interactive UI components (charts, tables, forms, quizzes, plots, Mermaid) inline inside assistant replies.