blender-mcp-setup
Skill4 starsChanged 21 days agoApache-2.0View on GitHub
Set up or diagnose the plugin-owned Blender MCP connection when Blender is missing, the Add-on is disabled, Start MCP Server has not been clicked, or no guarded Harness session is discoverable.
In this repository44 other files it gives its agents.
- AGENTS.mdAGENTS.md
- openspec-apply-changeSkill
- openspec-archive-changeSkill
- openspec-exploreSkill
- openspec-proposeSkill
- openspec-sync-specsSkill
- openspec-update-changeSkill
- blender-ai-replicationSkill
- blender-asset-librarySkill
- blender-background-jobsSkill
- blender-character-animationSkill
- blender-character-riggingSkill
- blender-cinematographySkill
- blender-connectorSkill
- blender-curvesSkill
- blender-design-loopSkill
- blender-designSkill
- blender-exportSkill
- blender-grease-pencilSkill
- blender-hairSkill
- blender-hard-surfaceSkill
- blender-harness-drivingSkill
- blender-harnessSkill
- blender-inspectSkill
- blender-managedSkill
- blender-previewSkill
- blender-previsSkill
- blender-procedural-modelingSkill
- blender-quality-validationSkill
- blender-recoverSkill
- blender-render-compositingSkill
- blender-retopologySkill
- blender-scene-assemblySkill
- blender-sculpt-surfaceSkill
- blender-seedance-pipelineSkill
- blender-sequence-editingSkill
- blender-simulationSkill
- blender-to-dreaminaSkill
- blender-trackingSkill
- blender-useSkill
- blender-uv-materialSkill
- blender-video-originalSkill
- blender-video-recreateSkill
- blender-visual-loopSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 2 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Use this for first use and connection failures.
- Distinctive: line 13
Add-on into the user's Blender (pulling the latest package from GitHub Releases, falling back to the bundled offline package), enables it …
- Very specific: line 17
When it returns connected: true, tell the user in Chinese that Blender 已自动连接 and summarize the installed package source and output …
- Very specific: line 19
When it returns ok: false, relay manualHint verbatim to the user.
- Very specific: line 24
Only after blender_auto_setup fails or the user explicitly prefers manual setup, present the illustrated manual path: …
- Distinctive: line 29
Use this manual-fallback summary only in step 4:
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Blender MCP Setup
Use this for first use and connection failures. Call blender_connection_status before doing
anything else. If it is not connected, run blender_auto_setup first — it is the automated
first-run path and requires no manual steps from the user:
blender_auto_setupdiscovers the local Blender installation, installs the PartMe Blender MCP Add-on into the user's Blender (pulling the latest package from GitHub Releases, falling back to the bundled offline package), enables it persistently, and launches Blender with the connector auto-started against the default approved output root (~/partme/blender/design-outputs).- When it returns
connected: true, tell the user in Chinese that Blender 已自动连接 and summarize the installed package source and output directory. Setup is done — no manual steps. - When it returns
ok: false, relaymanualHintverbatim to the user. The two common cases:stage: discover— Blender 未安装：给出官网下载链接 https://www.blender.org/download/ ， 装好后让用户再说一次"连接 Blender"即可。stage: enable且检测到 Blender 正在运行：请用户完全退出 Blender 后重试blender_auto_setup（自动路径），或改走下面的手动步骤。
- Only after
blender_auto_setupfails or the user explicitly prefers manual setup, present the illustrated manual path:blender_getting_started, then the Chinese setup guide getting-started.zh-CN.md or the English guide getting-started.md.
Use this manual-fallback summary only in step 4:
打开 Blender，在 偏好设置 > 插件 中启用 MCP 插件，然后在 N 面板中点击 Start MCP Server。
The trusted Add-on name is PartMe Blender MCP (N-panel category PartMe MCP). A separately installed community Add-on named MCP for Blender is not the endpoint for this plugin and must not be treated as proof that the Blender Harness is connected.
blender_auto_setup is the product-approved automation: it may install the Add-on into Blender's
user add-ons directory, enable it persistently, and launch Blender. Any other system change still
requires the user's authorization. Never request or display the private Harness descriptor token.
For error-specific recovery, supported/unsupported boundaries, common misrouting patterns, and first-use examples, read setup troubleshooting.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.