{"slug": "mcp-for-blender-2-3-1-connect-ai-agents-to-blender-in-one-command", "title": "mcp-for-blender 2.3.1: Connect AI Agents to Blender in One Command", "summary": "Mcp-for-blender 2.3.1, the community MCP server with 35,000 GitHub stars and 4 million PyPI downloads, shipped on November 18, 2026, letting Claude Code, Cursor, and Codex agents drive Blender's Python runtime through a TCP socket on localhost:9876 via nine exposed tools including execute_blender_code, get_scene_info, look, and generate_3d. The release carries a documented security risk: execute_blender_code runs arbitrary Python with no sandboxing by default, and GitHub issue #201 confirmed the exposure as exploitable rather than theoretical, with the project pointing users to the environment variable BLENDER_MCP_SAFE_MODE=1 as the mitigation. The tool's limits are also explicit — the agent writes valid Python but does not understand topology, edge flow, subdivision readiness, or mesh quality for animation.", "body_md": "mcp-for-blender — the community MCP server with 35,000 GitHub stars and 4 million PyPI downloads — released version 2.3.1 on November 18, 2026. If you use Claude Code, Cursor, or Codex, you can now wire your AI coding agent directly into Blender’s Python runtime with a single command. The setup is fast. The use cases are real. And there is one security risk you need to understand before you go further.\n\n## How It Works (The Architecture Matters)\n\nMost AI-to-3D tools work by generating a mesh file and handing it back to you. mcp-for-blender does something different: it gives your agent a live, two-way connection to Blender itself.\n\nThe system has two components. A Python addon runs inside Blender and opens a TCP socket server on `localhost:9876`. The [MCP server on PyPI](https://pypi.org/project/mcp-for-blender/) bridges your AI client to that socket. When your agent calls a tool, the MCP server sends a JSON command over TCP, and the addon executes `bpy` (Blender’s Python API) inside your running Blender instance. The agent isn’t generating a file — it’s driving Blender’s Python runtime in real time, with feedback available on every call.\n\nNine tools are exposed to the AI client. The most used is `execute_blender_code`, which sends Python directly to Blender. `get_scene_info` returns a compact scene summary. `look` takes a viewport screenshot so the agent can verify what it built. `generate_3d` pulls a mesh from Tripo, Hunyuan3D, Meshy, or Hyper3D Rodin and imports it in one call. `generate_gaussian_world` — added in 2.3.0 — creates explorable environments via World Labs.\n\n## Setup: Three Steps\n\nGetting running takes about five minutes.\n\n**Step 1: Install the MCP server.** The universal installer handles Claude Code, Cursor, Codex, VS Code, and Windsurf at once:\n\n```\nuvx mcp-for-blender setup\n```\n\nFor Claude Code only:\n\n```\nclaude mcp add blender uvx mcp-for-blender\n```\n\nFor Cursor, add this to `.cursor/mcp.json` in your project root:\n\n```\n{\n  \"mcpServers\": {\n    \"blender\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-for-blender\"]\n    }\n  }\n}\n```\n\n**Step 2: Enable the Blender addon.** Run `uvx mcp-for-blender install-addon`, then in Blender go to Edit → Preferences → Add-ons and enable **Interface: MCP for Blender**.\n\n**Step 3: Start the server.** In Blender’s 3D Viewport, press **N** to open the side panel. Open the MCP for Blender tab and click **Start MCP Server**.\n\n## What It Can Actually Do\n\n- **Scene assembly.** Describe a scene and the agent sources assets from Poly Haven, Sketchfab, or Poly Pizza, imports them, positions them, and sets up lighting — without you touching the Blender UI.\n- **Material generation.** Describe a material in prose (“worn concrete with water stains”) and the agent builds a full shader node tree in Blender’s node editor. Faster than building nodes by hand for standard materials.\n- **Rigging boilerplate.** Bone creation, weight painting setup, constraint linking — the mechanical parts of rigging that everyone dreads.\n- **Batch operations.** Rename hundreds of objects by convention. Convert legacy materials to Principled BSDF. Adjust UV scales across an entire scene.\n\nThe limits are real. The agent writes valid Python but does not understand topology — edge flow, subdivision readiness, and mesh quality for animation are not in scope. For anything requiring artistic judgment, treat the agent as a fast assistant that handles the mechanical parts.\n\n## The Security Risk You Should Not Skip\n\n`execute_blender_code` runs arbitrary Python inside Blender with no sandboxing by default. Because `bpy` has access to Python’s full standard library — including `os`, `subprocess`, and `socket` — a malicious prompt or prompt injection attack could execute arbitrary system commands on your machine. [GitHub issue #201](https://github.com/ahujasid/mcp-for-blender/issues/201) confirmed this as exploitable, not theoretical.\n\nThe fix is a one-line environment variable:\n\n```\nexport BLENDER_MCP_SAFE_MODE=1\n```\n\nSafe mode blocks file I/O, subprocess calls, network access, and persistent code installation. Set it before you start the server. In any shared or networked environment, treat this as non-optional.\n\n## Community vs. Official Blender MCP\n\nThe [Blender Foundation’s official MCP server](https://projects.blender.org/lab/blender_mcp) (v1.0.3) shipped in April 2026. It is simpler, more trustworthy from a security standpoint, and installs with one click — but it requires Blender 5.1 or newer and has no built-in generative AI integrations.\n\nmcp-for-blender works with Blender 3.0 and up, supports every major AI client, and includes Tripo, Meshy, Hunyuan3D, and World Labs integrations out of the box. If you are on Blender 5.1 and doing primarily inspection and automation, the official server is worth considering. Everyone else is on the [community version](https://github.com/ahujasid/mcp-for-blender).\n\nAt 35,000 GitHub stars and 4 million downloads, mcp-for-blender is effectively the standard. The 2.3.1 release is a good moment to get started if you have been watching from the sidelines.", "url": "https://wpnews.pro/news/mcp-for-blender-2-3-1-connect-ai-agents-to-blender-in-one-command", "canonical_source": "https://byteiota.com/mcp-for-blender-2-3-1-connect-ai-agents-blender/", "published_at": "2026-11-19 22:07:17+00:00", "updated_at": "2026-11-19 22:44:22.076547+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-tools", "developer-tools", "ai-safety"], "entities": ["mcp-for-blender", "Blender", "Claude Code", "Cursor", "Codex", "GitHub", "PyPI", "World Labs"], "also_reported_by": [], "takeaway": "mcp-for-blender 2.3.1 exposes nine tools over a localhost:9876 TCP socket so an agent executes bpy code directly in a running Blender instance, and because execute_blender_code is unsandboxed by default, setting BLENDER_MCP_SAFE_MODE=1 is the documented mitigation for the exploitable risk in GitHub ", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/mcp-for-blender-2-3-1-connect-ai-agents-to-blender-in-one-command", "markdown": "https://wpnews.pro/news/mcp-for-blender-2-3-1-connect-ai-agents-to-blender-in-one-command.md", "text": "https://wpnews.pro/news/mcp-for-blender-2-3-1-connect-ai-agents-to-blender-in-one-command.txt", "jsonld": "https://wpnews.pro/news/mcp-for-blender-2-3-1-connect-ai-agents-to-blender-in-one-command.jsonld"}}