{"_id":"blenderlens-mcp","_rev":"2-c1dc76dfdded4fb25f130ea164aeb191","name":"blenderlens-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.0.0-stage":{"name":"blenderlens-mcp","version":"0.0.0-stage","_id":"blenderlens-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"dist":{"shasum":"9d1c6662d066dfcf193094b1c6f1b6dc8370b2d2","tarball":"https://registry.npmjs.org/blenderlens-mcp/-/blenderlens-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-boY6v4tO0LqtCYR8t01SG55T0dA6Bm02slVZgf5HL3lVLLMC11PCAvL1ANyhul++WVoVYey9vrycNZjovI5K6g==","signatures":[{"sig":"MEUCIQD1LTaxuJlqjnJxpaEovRp/Xrp3I7NGOQl+0a8sg+FmvQIgCr7BKTiXhmQUrvgoT6hEJNdBoms3EZ2as77j9JsK3Jk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":337},"_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.2.0":{"_id":"blenderlens-mcp@0.2.0","bin":{"blenderlens-mcp":"bin/blenderlens-mcp.js"},"bugs":{"url":"https://github.com/pzalutski-pixel/blenderlens-mcp/issues"},"dist":{"shasum":"ffcf7dad15b41a9b3b2d1763308bc8ef5f436cef","tarball":"https://registry.npmjs.org/blenderlens-mcp/-/blenderlens-mcp-0.2.0.tgz","integrity":"sha512-CsBDxnxHQyfpoOpUixyu3qExejOaHaZ4CdkWIOSjw3lQNn8n7pb2ahi04DZaPIfdBwN94HU3O+91zsGCPgt8Aw==","fileCount":36,"unpackedSize":849207,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/blenderlens-mcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAPIY5OwRRCXknmIUmOJl6IFqTBmyOVze/6wsXxw1Q2fAiB2eGjChiFva23AEc4fKHHPgUwzjvsP08Fn137SeYfRqA=="}]},"name":"blenderlens-mcp","_from":"file:dist/blenderlens-mcp-0.2.0.tgz","author":{"name":"Peter Zalutski"},"engines":{"node":">=18"},"license":"Apache-2.0","mcpName":"io.github.pzalutski-pixel/blenderlens","version":"0.2.0","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com","approver":{"name":"pzalutski","email":"pzalutski@gmail.com"}},"homepage":"https://github.com/pzalutski-pixel/blenderlens-mcp","keywords":["mcp","mcp-server","blender","bpy","gltf","glb","godot","threejs","game-assets","3d-modeling","ai-agents","claude"],"_resolved":"/home/runner/work/blenderlens-mcp/blenderlens-mcp/dist/blenderlens-mcp-0.2.0.tgz","_integrity":"sha512-CsBDxnxHQyfpoOpUixyu3qExejOaHaZ4CdkWIOSjw3lQNn8n7pb2ahi04DZaPIfdBwN94HU3O+91zsGCPgt8Aw==","repository":{"url":"git+https://github.com/pzalutski-pixel/blenderlens-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server that lets AI agents build, check, preview and export game assets in Blender","directories":{},"maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"_nodeVersion":"24.21.0","_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/blenderlens-mcp_0.2.0_1791661540283_0.18732910418190496"},"_hasShrinkwrap":false}},"time":{"created":"2026-10-10T19:32:43.290Z","modified":"2026-10-10T19:45:40.663Z","0.0.0-stage":"2026-10-10T19:32:43.290Z","0.2.0":"2026-10-10T19:45:40.387Z"},"description":"MCP server that lets AI agents build, check, preview and export game assets in Blender","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"readme":"# blenderlens-mcp\n\n[![npm](https://img.shields.io/npm/v/blenderlens-mcp.svg)](https://www.npmjs.com/package/blenderlens-mcp)\n[![PyPI](https://img.shields.io/pypi/v/blenderlens-mcp.svg)](https://pypi.org/project/blenderlens-mcp/)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/pzalutski-pixel/blenderlens-mcp/blob/main/LICENSE)\n\nAn MCP server that lets an AI agent build 3D assets in **Blender itself**. The agent builds with Blender's own\noperations, looks at rendered previews, checks its work, and exports a `.glb` file that Godot 4 and three.js load.\nAfter each export, the server reads the written file back and reports what it contains. Everything runs on your\nmachine, and nothing is sent anywhere.\n\n## Requirements\n\n| Requirement | Needed for |\n|---|---|\n| **Blender 4.2 LTS or later** (CI tests 4.2 LTS and 5.0) | Everything. The server finds Blender through `BLENDER_BIN`, then `PATH`, then the usual install folders. |\n| **Python 3.10 or later** on `PATH` | This package runs the bundled server with it. |\n| **Node.js 18 or later** | `npx` and this package's launcher. |\n| The BlenderLens add-on in Blender | Live mode only, where the agent works in a Blender window that you watch. |\n\nNo GPU is needed for previews in the default style, which render with Cycles on the CPU.\n\n## Quick start\n\nAdd this to your MCP client's configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"blenderlens\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"blenderlens-mcp\"],\n      \"env\": {\n        \"BLENDER_BIN\": \"C:\\\\Program Files\\\\Blender Foundation\\\\Blender 5.0\\\\blender.exe\"\n      }\n    }\n  }\n}\n```\n\nIf the add-on is not started in a Blender window, the server starts `blender --background` itself and keeps it\nrunning. To have the agent work in a Blender window that you watch instead, install the add-on, then press\n**Start** in its panel (press N in the 3D viewport and open the BlenderLens tab):\n\n```bash\nnpx -y blenderlens-mcp install-addon\n```\n\n## What this package contains\n\nThis package contains the whole server, which is written in Python and has **no dependencies**. It looks for\nPython 3.10 or later (`python3`, `python`, or `py -3` on Windows) in the folders listed on `PATH`, using only\nabsolute paths and never the current working directory, and runs the server over stdio. Nothing is downloaded after\ninstallation. The same server is available from PyPI: `uvx blenderlens-mcp`.\n\n## Tools\n\n- **Session:** `get_status`, `open_session`, `close_session`\n- **Inspecting:** `get_scene`, `get_object`, `get_mesh`, `list_materials`\n- **Checking:** `check_asset` (geometry, UVs, textures, a triangle budget and a project's own rules, checked as\n  the asset will be exported), `measure_objects`\n- **Building:** `create_object` (including tubes, lathed shapes and text), `create_mesh`, `edit_mesh`,\n  `add_modifier`, `set_modifier`, `apply_modifier`, `remove_modifier`, `set_material`, `set_vertex_color`,\n  `unwrap_uv`, `join_objects`, `animate_object`, `create_collision`, `bake_texture`\n- **Arranging:** `set_transform` (which can drop an object onto what is below it), `apply_transform` (which can\n  move the origin), `set_parent`, `set_collection`, `set_object`, `duplicate_object`, `delete_object`\n- **Files:** `export_glb` for Godot or three.js (written, read back from disk, and checked for problems in the\n  target engine), `export_file` (FBX, OBJ, STL, PLY, USD), `import_file`, `save_file`, `open_file`, `create_file`\n- **Seeing:** `render_preview`, including sheets of several views\n- **Python:** `run_python`, `run_script`\n- **Undoing:** `undo_change`\n\nTo check an asset without an agent, for example in CI:\n`npx -y blenderlens-mcp check asset.glb --budget 5000 --target godot`.\n\nUnits are metres, and rotations are in degrees. When a tool refuses a call, it returns a structured error with an\n`exit` code, a `kind` and a `hint`.\n\n## Configuration\n\n| Variable | Default | Description |\n|---|---|---|\n| `BLENDER_BIN` | found automatically | The Blender executable, used for background mode and `install-addon` |\n| `BLENDERLENS_MODE` | `auto` | `auto` (live mode if the add-on responds, otherwise background mode), `live` or `background` |\n| `BLENDERLENS_HOST` | `127.0.0.1` | The address at which the server connects to the add-on. It must match the add-on's Host preference. |\n| `BLENDERLENS_PORT` | `9877` | The add-on's port, as set in its preferences |\n| `BLENDERLENS_TOKEN` | not set | The add-on's token. When it is not set, the server reads the token from the add-on's connection file, `live-<port>.json`. |\n| `BLENDERLENS_TIMEOUT` | `120` | Seconds to wait for one call |\n| `BLENDERLENS_START_TIMEOUT` | `90` | Seconds to wait for a background Blender to start |\n| `BLENDERLENS_RENDER_DIR` | `blenderlens/renders` in the temporary folder | Where `render_preview` writes when given no `path` |\n| `BLENDERLENS_ALLOW_PYTHON` | `1` | `0` removes `run_python` and `run_script` from the tool list and refuses them |\n| `BLENDERLENS_ALLOWED_DIRS` | not set | A list of folders, separated by `;` on Windows and `:` elsewhere. Every path given to a tool must be inside one of them, or the call is refused as `not_allowed`; `render_preview` may also write to the render folder (`BLENDERLENS_RENDER_DIR`, or its default). Libraries linked by a `.blend` are reported, not blocked. |\n| `BLENDERLENS_RUNTIME_DIR` | a per-user folder | Where the add-on writes `live-<port>.json` for the server, and where recovery copies of unsaved work are saved |\n\n## Documentation\n\nThe full tool reference, the conventions and the list of error kinds are at\n[github.com/pzalutski-pixel/blenderlens-mcp](https://github.com/pzalutski-pixel/blenderlens-mcp).\n\nBlenderLens is not affiliated with or endorsed by the Blender Foundation.\n\n## License\n\nApache License 2.0.\n","readmeFilename":"README.md","homepage":"https://github.com/pzalutski-pixel/blenderlens-mcp","keywords":["mcp","mcp-server","blender","bpy","gltf","glb","godot","threejs","game-assets","3d-modeling","ai-agents","claude"],"repository":{"url":"git+https://github.com/pzalutski-pixel/blenderlens-mcp.git","type":"git"},"author":{"name":"Peter Zalutski"},"bugs":{"url":"https://github.com/pzalutski-pixel/blenderlens-mcp/issues"},"license":"Apache-2.0"}