blendrelay-mcp 0.7.0__tar.gz

blendrelay_mcp-0.7.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BlendRelay MCP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

blendrelay_mcp-0.7.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: blendrelay-mcp
+Version: 0.7.0
+Summary: General-purpose MCP server and AI workflow extension for Blender
+License-Expression: MIT AND GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/shefq/blendrelay-mcp
+Project-URL: Repository, https://github.com/shefq/blendrelay-mcp
+Project-URL: Issues, https://github.com/shefq/blendrelay-mcp/issues
+Keywords: blender,mcp,model-context-protocol,ai,3d
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Plugins
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: src/blendrelay_blender/COPYING.txt
+Dynamic: license-file
+
+# BlendRelay MCP
+
+**General-purpose AI agent control for Blender through MCP**
+
+BlendRelay MCP connects local AI agents to Blender 4.5+. It can inspect and change arbitrary Blender files for modeling, sculpting, shading, rigging, animation, Geometry Nodes, simulations, lighting, rendering, compositing, video editing, scene organization and automation.
+
+The Blender sidebar (**BlendRelay**) provides prompts, reference images, viewport sketches, target regions, selection context, quality profiles, permissions, and full-file recovery checkpoints. MCP tools perform the actual work.
+
+## Requirements
+
+- Blender 4.5 or newer.
+- Python 3.11 or newer and `uvx` (recommended) or `pip` for installation.
+- Prompts sent from Blender currently require a signed-in OpenAI Codex CLI or Google Antigravity CLI. Install only the backend you intend to use.
+- Claude Desktop, Claude Code, Cursor, and other MCP clients can connect directly to BlendRelay without Codex or Antigravity.
+
+---
+
+## Quick Start & Setup
+
+### 1. Install & Setup
+
+BlendRelay MCP is currently in local development and has not yet been published to PyPI:
+
+```powershell
+git clone https://github.com/shefq/blendrelay-mcp.git
+cd blendrelay-mcp
+python -m pip install -e .
+blendrelay-mcp setup
+```
+
+After the first PyPI release, users can install it with `uvx blendrelay-mcp setup` or `pip install blendrelay-mcp`.
+
+To run diagnostics and verify your environment:
+
+```powershell
+blendrelay-mcp doctor
+```
+
+### 2. Configure MCP Client
+
+Add BlendRelay MCP to your MCP client configuration (Claude Desktop, Claude Code, Cursor, Antigravity, etc.):
+
+```json
+{
+  "mcpServers": {
+    "blendrelay": {
+      "command": "python",
+      "args": ["-m", "blendrelay_mcp.cli", "mcp"]
+    }
+  }
+}
+```
+
+After the PyPI release, clients can instead launch it through `uvx`:
+
+```json
+{
+  "mcpServers": {
+    "blendrelay": {
+      "command": "uvx",
+      "args": ["blendrelay-mcp"]
+    }
+  }
+}
+```
+
+For Claude Code during local development:
+
+```powershell
+claude mcp add --scope user blendrelay -- python -m blendrelay_mcp.cli mcp
+claude mcp list
+```
+
+### 3. Enable Extension in Blender
+
+1. Open Blender.
+2. In **Edit → Preferences → Get Extensions / Add-ons**, enable **BlendRelay MCP**.
+3. In the 3D Viewport sidebar (press `N`), switch to the **BlendRelay** tab.
+4. Click **Connect / Refresh**.
+
+---
+
+## Data & Migration
+
+- **Shared Runtime Root**: `%LOCALAPPDATA%\BlendRelayMCP` (customizable via `BLENDRELAY_DATA_DIR`).
+- **Workspaces**: Scene-specific data is saved in `workspaces/<workspace-id>/`. The workspace ID is stored inside the `.blend` file (`blendrelay_workspace_id`).
+
+---
+
+## CLI Commands
+
+The unified `blendrelay-mcp` CLI provides:
+
+- `blendrelay-mcp` or `blendrelay-mcp mcp`: Start the MCP stdio gateway server.
+- `blendrelay-mcp setup [--target <path> | --blender-version <version>]`: Migrate data and install into the newest compatible Blender by default.
+- `blendrelay-mcp doctor [--strict]`: Validate Python, extension, and runtime health with a meaningful exit status.
+- `blendrelay-mcp install-addon [--target <path> | --blender-version <version>]`: Install the bundled extension.
+- `blendrelay-mcp runtime serve`: Run the background loopback runtime service manually.
+
+---
+
+## Blender Tools
+
+- `get_scene_info`, `get_object_info`, `inspect_scene`, and `inspect_blender_data` provide bounded structured context.
+- `mesh_edit` offers validated common mesh operations (extrude, inset, bevel, bridge, etc.).
+- `build_scene_batch` handles objects, materials, lights, cameras, transforms, parenting, modifiers, duplication, deletion, and keyframes.
+- `execute_blender_python` exposes the full Blender Python API with `br` helpers.
+- `capture_viewport` and `capture_focused_view` provide visual verification and multi-angle framing.
+- `blendrelay_blender_sessions`, `blendrelay_blender_job`, `blendrelay_get_capabilities`, `blendrelay_register_source`, and `blendrelay_read_artifact` manage session lifecycles, background jobs, and artifacts.
+- Scene checkpoints and restoration allow non-destructive undo and safety recovery.
+
+---
+
+## Workflows and Verification
+
+- **Workflows**: Auto mode classifies requests into creation, focused editing, shading, rigging, animation, nodes, simulation, rendering, compositing, sculpting, or data management.
+- **Profiles**: Four workload profiles control budgets: Focused Task, Full Creation, Creation + Assets, and Complex Production. Finish quality can be set from Draft to Maximum.
+- **Checkpoints**: BlendRelay automatically creates recovery checkpoints before an AI execution and a final checkpoint upon successful completion.
+- **Asset Library**: Searches local caches, Poly Haven, and Poly Pizza under the active license policy.
+
+---
+
+## Testing
+
+Run the test suite with:
+
+```powershell
+python -B -m unittest discover -s tests -p "test_*.py" -v
+```
+
+Build the extension package:
+
+```powershell
+python tools/build_extension.py
+```

blendrelay_mcp-0.7.0/README.md

@@ -0,0 +1,135 @@
+# BlendRelay MCP
+
+**General-purpose AI agent control for Blender through MCP**
+
+BlendRelay MCP connects local AI agents to Blender 4.5+. It can inspect and change arbitrary Blender files for modeling, sculpting, shading, rigging, animation, Geometry Nodes, simulations, lighting, rendering, compositing, video editing, scene organization and automation.
+
+The Blender sidebar (**BlendRelay**) provides prompts, reference images, viewport sketches, target regions, selection context, quality profiles, permissions, and full-file recovery checkpoints. MCP tools perform the actual work.
+
+## Requirements
+
+- Blender 4.5 or newer.
+- Python 3.11 or newer and `uvx` (recommended) or `pip` for installation.
+- Prompts sent from Blender currently require a signed-in OpenAI Codex CLI or Google Antigravity CLI. Install only the backend you intend to use.
+- Claude Desktop, Claude Code, Cursor, and other MCP clients can connect directly to BlendRelay without Codex or Antigravity.
+
+---
+
+## Quick Start & Setup
+
+### 1. Install & Setup
+
+BlendRelay MCP is currently in local development and has not yet been published to PyPI:
+
+```powershell
+git clone https://github.com/shefq/blendrelay-mcp.git
+cd blendrelay-mcp
+python -m pip install -e .
+blendrelay-mcp setup
+```
+
+After the first PyPI release, users can install it with `uvx blendrelay-mcp setup` or `pip install blendrelay-mcp`.
+
+To run diagnostics and verify your environment:
+
+```powershell
+blendrelay-mcp doctor
+```
+
+### 2. Configure MCP Client
+
+Add BlendRelay MCP to your MCP client configuration (Claude Desktop, Claude Code, Cursor, Antigravity, etc.):
+
+```json
+{
+  "mcpServers": {
+    "blendrelay": {
+      "command": "python",
+      "args": ["-m", "blendrelay_mcp.cli", "mcp"]
+    }
+  }
+}
+```
+
+After the PyPI release, clients can instead launch it through `uvx`:
+
+```json
+{
+  "mcpServers": {
+    "blendrelay": {
+      "command": "uvx",
+      "args": ["blendrelay-mcp"]
+    }
+  }
+}
+```
+
+For Claude Code during local development:
+
+```powershell
+claude mcp add --scope user blendrelay -- python -m blendrelay_mcp.cli mcp
+claude mcp list
+```
+
+### 3. Enable Extension in Blender
+
+1. Open Blender.
+2. In **Edit → Preferences → Get Extensions / Add-ons**, enable **BlendRelay MCP**.
+3. In the 3D Viewport sidebar (press `N`), switch to the **BlendRelay** tab.
+4. Click **Connect / Refresh**.
+
+---
+
+## Data & Migration
+
+- **Shared Runtime Root**: `%LOCALAPPDATA%\BlendRelayMCP` (customizable via `BLENDRELAY_DATA_DIR`).
+- **Workspaces**: Scene-specific data is saved in `workspaces/<workspace-id>/`. The workspace ID is stored inside the `.blend` file (`blendrelay_workspace_id`).
+
+---
+
+## CLI Commands
+
+The unified `blendrelay-mcp` CLI provides:
+
+- `blendrelay-mcp` or `blendrelay-mcp mcp`: Start the MCP stdio gateway server.
+- `blendrelay-mcp setup [--target <path> | --blender-version <version>]`: Migrate data and install into the newest compatible Blender by default.
+- `blendrelay-mcp doctor [--strict]`: Validate Python, extension, and runtime health with a meaningful exit status.
+- `blendrelay-mcp install-addon [--target <path> | --blender-version <version>]`: Install the bundled extension.
+- `blendrelay-mcp runtime serve`: Run the background loopback runtime service manually.
+
+---
+
+## Blender Tools
+
+- `get_scene_info`, `get_object_info`, `inspect_scene`, and `inspect_blender_data` provide bounded structured context.
+- `mesh_edit` offers validated common mesh operations (extrude, inset, bevel, bridge, etc.).
+- `build_scene_batch` handles objects, materials, lights, cameras, transforms, parenting, modifiers, duplication, deletion, and keyframes.
+- `execute_blender_python` exposes the full Blender Python API with `br` helpers.
+- `capture_viewport` and `capture_focused_view` provide visual verification and multi-angle framing.
+- `blendrelay_blender_sessions`, `blendrelay_blender_job`, `blendrelay_get_capabilities`, `blendrelay_register_source`, and `blendrelay_read_artifact` manage session lifecycles, background jobs, and artifacts.
+- Scene checkpoints and restoration allow non-destructive undo and safety recovery.
+
+---
+
+## Workflows and Verification
+
+- **Workflows**: Auto mode classifies requests into creation, focused editing, shading, rigging, animation, nodes, simulation, rendering, compositing, sculpting, or data management.
+- **Profiles**: Four workload profiles control budgets: Focused Task, Full Creation, Creation + Assets, and Complex Production. Finish quality can be set from Draft to Maximum.
+- **Checkpoints**: BlendRelay automatically creates recovery checkpoints before an AI execution and a final checkpoint upon successful completion.
+- **Asset Library**: Searches local caches, Poly Haven, and Poly Pizza under the active license policy.
+
+---
+
+## Testing
+
+Run the test suite with:
+
+```powershell
+python -B -m unittest discover -s tests -p "test_*.py" -v
+```
+
+Build the extension package:
+
+```powershell
+python tools/build_extension.py
+```

blendrelay_mcp-0.7.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "blendrelay-mcp"
+dynamic = ["version"]
+description = "General-purpose MCP server and AI workflow extension for Blender"
+requires-python = ">=3.11"
+readme = "README.md"
+license = "MIT AND GPL-3.0-or-later"
+license-files = ["LICENSE", "src/blendrelay_blender/COPYING.txt"]
+dependencies = []
+keywords = ["blender", "mcp", "model-context-protocol", "ai", "3d"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Plugins",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Graphics :: 3D Modeling",
+]
+
+[project.urls]
+Homepage = "https://github.com/shefq/blendrelay-mcp"
+Repository = "https://github.com/shefq/blendrelay-mcp"
+Issues = "https://github.com/shefq/blendrelay-mcp/issues"
+
+[project.scripts]
+blendrelay-mcp = "blendrelay_mcp.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "blendrelay_blender.version.__version__"}
+
+[tool.setuptools.package-data]
+blendrelay_blender = ["*.py", "blender_manifest.toml", "COPYING.txt"]

blendrelay_mcp-0.7.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+