dsh-blender-bridge

The DSH Blender plugin provides scene queries, viewport screenshots, bpy execution, scene export, and Poly Haven / Sketchfab asset tools through the official MCP client. Version 0.1.2.

Setup and use

Requires Node.js 22+, DSH with @deepseek-ai/dsh-mcp-client and @deepseek-ai/dsh-home-paths, and Blender 4.2+ / 5.x installed locally. The officially verified DSH runtime baseline is 0.2.1-alpha.3.

1. Find Blender Bridge on the NanoAI plugin platform and install it to the current DSH profile, or install the downloaded npm package with the official dsh plugin command. The package already includes the host, web client, skill, and Blender add-on ZIP; no build script is required.
2. Enable the plugin and call blender_addon_path in a conversation to obtain zipPath. The ZIP is at server/addon/dsh_blender_bridge.zip inside this plugin.
3. In Blender, open Preferences > Extensions > Install from Disk, select the ZIP, and enable the extension.
4. Open the 3D View sidebar with N, choose DSH > Start DSH Bridge. The default TCP address is 127.0.0.1:9876.
5. In DSH, call blender_status; after confirming the connection, use the scene and modeling tools.

The plugin details page shows service status and lets you configure the HTTP port and automatic startup. The default HTTP port is 39210; if it is occupied, the plugin selects an available port and connects MCP using the actual address. Port and auto-start changes take effect immediately. Turning auto-start off stops the service and releases its tools; turning it back on restores them. The HTTP port and Blender TCP port 9876 are separate.

Lifecycle and data

The host manages the child process through Cordis and creates an official MCP client owned by this plugin after the health check succeeds. Disabling or uninstalling the plugin, or changing the port, cleans up the connection and child process. The plugin does not rewrite profile configuration files.

Settings are stored at $DSH_HOME/companion-data/blender-bridge/settings.json, preserving the previous location. If DSH_HOME is unset, the official default directory ~/.dsh is used. The bundled blender-bridge skill is registered directly with the DSH skill service and removed when the plugin is disabled; it is not copied into the shared skills directory.

When upgrading from an older version, if the old dsh-blender-bridge-mcp or desktop-mcp-blender entry previously written to the profile still exists, remove that standalone MCP entry from the corresponding profile configuration and restart DSH. The new version creates its own connection; keeping the old entry can duplicate the blender tool namespace. You may also manually remove a same-named skill previously copied into the shared skills directory. Upgrading does not automatically modify these existing user files.

Set DSH_BLENDER_HOST and DSH_BLENDER_PORT before starting DSH to change the Blender TCP target. Poly Haven / Sketchfab integrations must be enabled in Blender's DSH panel, and Blender's Python environment must be able to import requests.

Permissions

This plugin starts a Node child process as the local user and listens on a loopback HTTP port. Its tools can execute Python through Blender, modify scenes, read and write imported/exported files, and access the network for selected asset integrations. Enable it only in a local Blender environment you trust.

Development and verification

npm test
npm pack --ignore-scripts

Tests use a temporary settings directory and simulated Blender TCP responses to check the MCP protocol, official client tool discovery, child-process startup/shutdown, and cleanup without modifying an existing Blender scene. The web settings page ships as an official window.__ModuleLoader__ module and does not need a separate build. Actual Blender GUI behavior, real asset-library downloads, and macOS/Linux device behavior must be verified on the target machine.

Official contract references: @deepseek-ai/dsh-package-manifest, @deepseek-ai/cordis, @deepseek-ai/dsh-mcp-client, @deepseek-ai/dsh-skill, and @deepseek-ai/dsh-client-ui-plugin-manager in the DSH installation. Upstream project: deepseek-ai/deepseek-harness.

License

MIT. The Blender extension comes from ahujasid/mcp-for-blender and its original ZIP is retained. Full license and third-party notices are included in the package.