{"_id":"fnf-blender-mcp","_rev":"5-48bfc176893332608992dc445892587b","name":"fnf-blender-mcp","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"fnf-blender-mcp","version":"0.1.0","keywords":["blender","mcp","higgsfield","3d","bpy"],"license":"MIT","_id":"fnf-blender-mcp@0.1.0","maintainers":[{"name":"arsu_higgsfield_ai","email":"arsu@higgsfield.ai"}],"homepage":"https://www.npmjs.com/package/fnf-blender-mcp","bin":{"fnf-blender":"dist/cli.js","fnf-blender-mcp":"dist/index.js"},"dist":{"shasum":"016b79da45067a8059fbc3fc6b05aecdce4ff91f","tarball":"https://registry.npmjs.org/fnf-blender-mcp/-/fnf-blender-mcp-0.1.0.tgz","fileCount":30,"integrity":"sha512-eo37o+ENz4J376bBBHx1iVvlmPkwp0OJnS1RM9j145KKUu7COHyFjEL7lptMqnU9uIx/clPka7q5RVKcKe4UDg==","signatures":[{"sig":"MEUCIQDIymVyqGEb3iYj3J7UQyIW5cl/2dFYAV9LxJ67MASGtAIgRKUdJWXTvBrm1qSDi0ldB/h1QEMTA5T0AVtWRCIORso=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":70246},"type":"module","_from":"file:fnf-blender-mcp-0.1.0.tgz","engines":{"node":">=24"},"scripts":{"test":"npm run build && node --test tests/*.test.mjs && python3 -m unittest discover -s tests -p \"test_*.py\"","build":"tsc","start":"node dist/index.js","prepack":"npm run build","typecheck":"tsc --noEmit","test:package":"node scripts/verify-package.mjs"},"_npmUser":{"name":"arsu_higgsfield_ai","email":"arsu@higgsfield.ai"},"_resolved":"/Users/arss/fnf-blender-mcp/fnf-blender-mcp-0.1.0.tgz","_integrity":"sha512-eo37o+ENz4J376bBBHx1iVvlmPkwp0OJnS1RM9j145KKUu7COHyFjEL7lptMqnU9uIx/clPka7q5RVKcKe4UDg==","_npmVersion":"11.9.0","description":"Higgsfield use Blender: local stdio MCP and authenticated loopback Blender add-on.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/server":"^2.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.2","@types/node":"^25.5.2","@modelcontextprotocol/client":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/fnf-blender-mcp_0.1.0_1789169379945_0.6394731952835413","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"fnf-blender-mcp","version":"0.2.0","keywords":["blender","mcp","higgsfield","3d","bpy"],"license":"MIT","_id":"fnf-blender-mcp@0.2.0","maintainers":[{"name":"arsu_higgsfield_ai","email":"arsu@higgsfield.ai"}],"homepage":"https://www.npmjs.com/package/fnf-blender-mcp","bugs":{"url":"https://github.com/higgsfield-ai/fnf-local-pluging-bridge-mcp/issues"},"bin":{"fnf-blender":"dist/cli.js","fnf-blender-mcp":"dist/index.js"},"dist":{"shasum":"47042fae98a075ce92c17a7a6dfe69988dd64ae1","tarball":"https://registry.npmjs.org/fnf-blender-mcp/-/fnf-blender-mcp-0.2.0.tgz","fileCount":28,"integrity":"sha512-XblPRC74SIL6buAmO1aAes8ymPYtnISx3Kx+Eo5VGi5qG1Vb7h8hR6e0K9CUoZbzUZZonFhyH0CjBO7BoN8AtA==","signatures":[{"sig":"MEUCIEp4f5tWxzjk8Me5IW0aRNxonTKlfaz1XgXelIh6eLa2AiEAvqPPocERBnRL8iFTN+SwWTtgm+SeXPliF/b0DFGoE7Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIEsVZjrgaQAM4hoXTTBSsw27LUezukqm/caoIqJCbHVHAiA3crHVXMxBtjE8RQCUc8YvxzJ9i4v+3R3/c47zBjkamg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62795},"type":"module","_from":"file:fnf-blender-mcp-0.2.0.tgz","engines":{"node":">=24"},"scripts":{"test":"npm run build && node --test tests/*.test.mjs && python3 -m unittest discover -s tests -p \"test_*.py\"","build":"tsc","start":"node dist/index.js","prepack":"npm run build","test:live":"npm run build && node scripts/verify-live.mjs","typecheck":"tsc --noEmit","test:package":"node scripts/verify-package.mjs"},"_npmUser":{"name":"arsu_higgsfield_ai","email":"arsu@higgsfield.ai"},"_resolved":"/Users/arss/fnf-local-pluging-bridge-mcp-blender/blender/fnf-blender-mcp-0.2.0.tgz","_integrity":"sha512-XblPRC74SIL6buAmO1aAes8ymPYtnISx3Kx+Eo5VGi5qG1Vb7h8hR6e0K9CUoZbzUZZonFhyH0CjBO7BoN8AtA==","repository":{"url":"git+https://github.com/higgsfield-ai/fnf-local-pluging-bridge-mcp.git","type":"git","directory":"blender"},"_npmVersion":"11.9.0","description":"Higgsfield use Blender: local stdio MCP controlling a background Blender process without add-ons.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/server":"^2.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.2","@types/node":"^25.5.2","@modelcontextprotocol/client":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/fnf-blender-mcp_0.2.0_1789231799836_0.11114520263603622","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"fnf-blender-mcp","version":"0.2.1","keywords":["blender","mcp","higgsfield","3d","bpy"],"license":"MIT","_id":"fnf-blender-mcp@0.2.1","maintainers":[{"name":"arsu_higgsfield_ai","email":"arsu@higgsfield.ai"}],"homepage":"https://www.npmjs.com/package/fnf-blender-mcp","bugs":{"url":"https://github.com/higgsfield-ai/fnf-local-pluging-bridge-mcp/issues"},"bin":{"fnf-blender":"dist/cli.js","fnf-blender-mcp":"dist/index.js"},"dist":{"shasum":"b8de8adf5c084d0ef99fc36c492530b4c41ab94f","tarball":"https://registry.npmjs.org/fnf-blender-mcp/-/fnf-blender-mcp-0.2.1.tgz","fileCount":77,"integrity":"sha512-oDrf60bXZ70D8jxOk0Gbzf9uN3OTeRl+ru2RiuZ7VuKArw7KV7Nw9ytBQ9sOI7I6bsHHoWuen3zNU5MLpTh4cw==","signatures":[{"sig":"MEUCIAplf8VC9ss0eabde6uBcBULFiuoa8JL+AFYWLKLoJj6AiEA0j3PasB4BJKmdW3xJz3Xp/+CDUu0BZ92/6TYfXc1tcc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCOyS04T3UIFXLg6pla0MkHPObWnKoxP9VnHJXRzNCprwIhAMpkbwfdUE0FMDDV3YdmX1GttizfBn9X/JKauIYl590R","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12056302},"type":"module","_from":"file:/Users/arss/cli-global/fnf-npm-releases/artifacts/20260923-blender/fnf-blender-mcp-0.2.1.tgz","engines":{"node":">=24"},"scripts":{"test":"npm run build && node --test tests/*.test.mjs && python3 -m unittest discover -s tests -p \"test_*.py\"","build":"tsc","start":"node dist/index.js","prepack":"npm run build","test:live":"npm run build && node scripts/verify-live.mjs","typecheck":"tsc --noEmit","test:package":"node scripts/verify-package.mjs"},"_npmUser":{"name":"arsu_higgsfield_ai","email":"arsu@higgsfield.ai"},"_resolved":"/Users/arss/cli-global/fnf-npm-releases/artifacts/20260923-blender/fnf-blender-mcp-0.2.1.tgz","_integrity":"sha512-oDrf60bXZ70D8jxOk0Gbzf9uN3OTeRl+ru2RiuZ7VuKArw7KV7Nw9ytBQ9sOI7I6bsHHoWuen3zNU5MLpTh4cw==","repository":{"url":"git+https://github.com/higgsfield-ai/fnf-local-pluging-bridge-mcp.git","type":"git","directory":"blender"},"_npmVersion":"11.13.0","description":"Higgsfield use Blender: local stdio MCP controlling a background Blender process without add-ons.","directories":{},"_nodeVersion":"24.16.0","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/server":"^2.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.2","@types/node":"^25.5.2","@modelcontextprotocol/client":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/fnf-blender-mcp_0.2.1_1790182568391_0.9585762211887929","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"_id":"fnf-blender-mcp@0.2.2","bin":{"fnf-blender":"dist/cli.js","fnf-blender-mcp":"dist/index.js"},"dist":{"shasum":"2ac2a529a8c19698f438c78a794557b3353447ef","tarball":"https://registry.npmjs.org/fnf-blender-mcp/-/fnf-blender-mcp-0.2.2.tgz","fileCount":76,"integrity":"sha512-7HEJjrThWmFgjDE3xYJfLC09EMmYDeFWwR4zLBfP8eQEeNdvYWOCgt910Lj3rfNFbmW6gGQxsZ4i6D+OT773ng==","signatures":[{"sig":"MEYCIQDQnAe7SKR8jw+z8LqdE/M4H8hFz1yzKBUlxQBfqkSgFAIhAIMxktaa7KyzaYKHxchj4dBZvvSwNc0LX+Hxz0RmGnMX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEQRgWeN+UA5+ujRCQqKU5H5gL97VnHIG+xJ18LFOpGVAiAutMWFKfbg3rCElLbUE04sNxyoWR93ImcRn4Tw4kAkpg=="}],"unpackedSize":12052993},"name":"fnf-blender-mcp","type":"module","_from":"file:/tmp/higgsfield-npm-release.PCGgtb/fnf-blender-mcp-0.2.2.tgz","engines":{"node":">=24"},"license":"MIT","scripts":{"test":"npm run build && node --test tests/*.test.mjs && python3 -m unittest discover -s tests -p \"test_*.py\"","build":"tsc","start":"node dist/index.js","prepack":"npm run build","test:live":"npm run build && node scripts/verify-live.mjs","typecheck":"tsc --noEmit","test:package":"node scripts/verify-package.mjs"},"version":"0.2.2","_npmUser":{"name":"alensultanov_higgsfield_ai","email":"alen.sultanov@higgsfield.ai"},"keywords":["blender","mcp","higgsfield","3d","bpy"],"_resolved":"/tmp/higgsfield-npm-release.PCGgtb/fnf-blender-mcp-0.2.2.tgz","_integrity":"sha512-7HEJjrThWmFgjDE3xYJfLC09EMmYDeFWwR4zLBfP8eQEeNdvYWOCgt910Lj3rfNFbmW6gGQxsZ4i6D+OT773ng==","_npmVersion":"11.19.0","description":"Local MCP server for Blender with a background process and offline creative skills.","directories":{},"maintainers":[{"name":"arsu_higgsfield_ai","email":"arsu@higgsfield.ai"},{"name":"alensultanov_higgsfield_ai","email":"alen.sultanov@higgsfield.ai"}],"_nodeVersion":"26.8.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/server":"^2.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.2","@types/node":"^25.5.2","@modelcontextprotocol/client":"^2.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fnf-blender-mcp_0.2.2_1790192955260_0.051460234641293345"}}},"time":{"created":"2026-09-11T23:29:39.784Z","modified":"2026-09-23T19:49:15.649Z","0.1.0":"2026-09-11T23:29:40.087Z","0.2.0":"2026-09-12T16:49:59.931Z","0.2.1":"2026-09-23T16:56:08.620Z","0.2.2":"2026-09-23T19:49:15.492Z"},"license":"MIT","keywords":["blender","mcp","higgsfield","3d","bpy"],"description":"Local MCP server for Blender with a background process and offline creative skills.","maintainers":[{"name":"arsu_higgsfield_ai","email":"arsu@higgsfield.ai"},{"name":"alensultanov_higgsfield_ai","email":"alen.sultanov@higgsfield.ai"}],"readme":"# Higgsfield Blender MCP\n\nLocal MCP server that controls a dedicated background Blender process. No add-on, HTTP listener, WebSocket, cloud account or open Blender window is required.\n\n```text\nDesktop MCP client → stdio → Node MCP → process pipes → Blender --background → bpy\n```\n\nEach MCP connection owns one process. Its scene persists between commands; it cannot access unsaved work in an already-open desktop Blender. Open saved input with `bl_open_project`, edit and render, then save a `.blend` output to inspect in the desktop UI. Disconnecting loses unsaved session changes.\n\n## Requirements\n\n- Node.js 24 or later with npm.\n- Blender 4.2 or later on the same computer as the MCP client.\n\n## Installation\n\n```sh\nblenderDir=\"$HOME/.higgsfield/blender-mcp\"\nnpm install --prefix \"$blenderDir\" fnf-blender-mcp@latest\nblenderCli=\"$blenderDir/node_modules/fnf-blender-mcp/dist/cli.js\"\nnode \"$blenderCli\" doctor --blender \"/absolute/path/to/blender\"\nnode \"$blenderCli\" config --blender \"/absolute/path/to/blender\" --format json\n```\n\nUse the executable inside `Blender.app/Contents/MacOS/Blender` on macOS, or `blender.exe` on Windows. `config --format toml` prints a Codex entry. Both formats include absolute Node/server paths and `BLENDER_EXECUTABLE`; merge the entry into the intended client and refresh its connection. The helper prints configuration but does not register a server. The installed package includes a `use-blender` skill with additional setup guidance.\n\nThe server starts Blender on its first execution call. `doctor` checks a separate temporary background process and terminates it afterward. Verify conversation access with `bl_health` and `bl_get_scene_summary`. `BLENDER_EXECUTABLE` can be set directly; without it the runtime tries standard installation locations and PATH. No separate Python installation is needed at runtime.\n\n## Tools\n\n| Area | Tools |\n| --- | --- |\n| Inspect | `bl_health`, `bl_get_scene_summary`, `bl_get_object` |\n| Scene | `bl_add_primitive`, `bl_delete_object`, `bl_set_transform`, `bl_set_material`, `bl_import_model` |\n| Camera/light | `bl_add_camera`, `bl_set_active_camera`, `bl_add_light` |\n| Animation | `bl_set_frame`, `bl_insert_keyframe` |\n| Files | `bl_save_project`, `bl_open_project` |\n| Evidence | `bl_render` |\n| Python/status | `bl_execute`, `bl_job_status` |\n| Offline guidance | `bl_list_skills`, `bl_get_skill`, `bl_get_skill_asset` |\n\nStart with `bl_get_skill(name: \"blender-scene\")`. Python runs sequentially on the process's main thread. Scene datablocks persist, while script-local variables do not. Assign a JSON-compatible `result` to return data. Python stdout/stderr are capped at 64 Ki characters each; JSON results are limited to 4 MiB. Native Blender diagnostics do not enter the MCP stdout protocol.\n\nThe npm archive contains the Blender craft modules. `bl_list_skills` lists the modules in the installed package and their references/assets; `bl_get_skill` reads an entry or reference, and `bl_get_skill_asset` returns the local path of a bundled file. The original five `bl_get_skill` names remain valid. An MCP client can read this guidance directly without installing the modules as client-side skills; client-side installation is optional for hosts that support automatic skill activation. Existing installations do not gain new modules or tools until the npm package is updated and the MCP connection refreshed. Skill guidance does not execute Blender operations or prove a live connection.\n\nRender a camera frame to PNG; files up to 4 MiB receive an inline preview. Cycles supports sample overrides. Save/render require `overwrite: true` for existing output files; opening a different project refuses unsaved changes unless explicitly discarded. Arbitrary Python is not sandboxed and can bypass these typed-tool guards. Automatic execution of Python embedded in opened `.blend` files is disabled.\n\n## Troubleshooting and limits\n\nA timed-out job continues and keeps its `job_id`. Query `bl_job_status` before retrying; additional execution commands are rejected while it runs. No automatic retries or rollbacks occur. Status retains at most 128 jobs within the MCP process. If Blender crashes, the session fails and is not restarted automatically: inspect output files before reconnecting to a new empty session. Closing the MCP terminates its child process, including a running job; save needed changes first.\n\nUse camera renders for visual evidence. No existing desktop scenes, preferences or installed add-ons are modified during startup. Multiple MCP connections have separate background scenes.\n\nVerified on macOS arm64 with Blender 4.2.23 LTS: persistent scene, mesh/material/camera/light edits, keyframes, save/reopen guards and a Cycles PNG preview. Windows/Linux native Blender execution has not been verified locally.\n\nThe installed package includes `UPSTREAM.md` and `LICENSE` for provenance and licensing details.\n\nBackground Blender does not reliably mark direct Python edits as dirty. The MCP also tracks attempted mutations, including failed commands and arbitrary `bl_execute` calls, conservatively as unsaved until `bl_save_project` or an explicitly permitted `bl_open_project` succeeds. Read tools preserve this state.\n","readmeFilename":"README.md"}