Metadata-Version: 2.4
Name: blender-llm-mcp
Version: 0.1.0
Summary: MCP server for Blender 3D — expose Blender modeling tools via Model Context Protocol
Author-email: Yan Weitao <yanweitao@hotmail.com>
License: MIT
Project-URL: Homepage, https://github.com/WeitaoYan/blender-llm-assistant
Project-URL: Repository, https://github.com/WeitaoYan/blender-llm-assistant
Project-URL: Documentation, https://github.com/WeitaoYan/blender-llm-assistant#readme
Keywords: blender,mcp,model-context-protocol,ai,3d-modeling
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.28.0

# blender-llm-mcp

MCP (Model Context Protocol) server for Blender 3D.

Connect AI assistants to Blender via [Model Context Protocol](https://modelcontextprotocol.io).

## Usage

Requires the [Blender LLM Assistant](https://github.com/WeitaoYan/blender-llm-assistant) addon running in Blender (HTTP API on `127.0.0.1:15800`).

```bash
# Install
pip install blender-llm-mcp

# Run
blender-llm-mcp

# Or with uvx (no install needed)
uvx blender-llm-mcp

# Custom Blender URL
blender-llm-mcp --blender-url http://127.0.0.1:15800
```

## Configuration in Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-llm-mcp"]
    }
  }
}
```

## How it works

```
Claude Desktop / VS Code / any MCP client
    │  MCP stdio protocol
    ▼
blender-llm-mcp
    │  HTTP (SSE)
    ▼
Blender LLM Assistant addon (inside Blender)
    │  Blender Python API (bpy)
    ▼
Blender 3D scene
```

The MCP server translates MCP tool calls into HTTP requests to the Blender addon.
