# 安装 three.ws Blender

- 类型: MCP 工具
- 说明: Drive a local Blender headlessly: inspect, convert, render and script 3D files.
- 仓库: https://github.com/nirholas/three.ws

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "three.ws Blender" MCP 服务：
执行：claude mcp add 'io-github-nirholas-blender-mcp' -- npx -y @three-ws/blender-mcp
```

### Codex
```
请帮我安装 askskill 上的 "three.ws Blender" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-nirholas-blender-mcp]
command = "npx"
args = ["-y","@three-ws/blender-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "three.ws Blender" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-nirholas-blender-mcp": { "command": "npx", "args": ["-y","@three-ws/blender-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env BLENDER_PATH=YOUR_VALUE --env BLENDER_MCP_TIMEOUT_MS=YOUR_VALUE --env BLENDER_MCP_WORKDIR=YOUR_VALUE --env BLENDER_MCP_ALLOW_PYTHON=YOUR_VALUE --env BLENDER_MCP_INLINE_IMAGE_BYTES=YOUR_VALUE --env BLENDER_MCP_INLINE_IMAGE_PX=YOUR_VALUE --env BLENDER_MCP_MAX_CONCURRENCY=YOUR_VALUE --env THREE_WS_BASE=YOUR_VALUE --env THREE_WS_FORGE_TIMEOUT_MS=YOUR_VALUE --env THREE_WS_FORGE_PROVIDER_KEY=YOUR_VALUE --transport stdio io-github-nirholas-blender-mcp -- npx -y @three-ws/blender-mcp
```
需要环境变量：BLENDER_PATH, BLENDER_MCP_TIMEOUT_MS, BLENDER_MCP_WORKDIR, BLENDER_MCP_ALLOW_PYTHON, BLENDER_MCP_INLINE_IMAGE_BYTES, BLENDER_MCP_INLINE_IMAGE_PX, BLENDER_MCP_MAX_CONCURRENCY, THREE_WS_BASE, THREE_WS_FORGE_TIMEOUT_MS, THREE_WS_FORGE_PROVIDER_KEY

### Codex
```bash
codex mcp add --env BLENDER_PATH=YOUR_VALUE --env BLENDER_MCP_TIMEOUT_MS=YOUR_VALUE --env BLENDER_MCP_WORKDIR=YOUR_VALUE --env BLENDER_MCP_ALLOW_PYTHON=YOUR_VALUE --env BLENDER_MCP_INLINE_IMAGE_BYTES=YOUR_VALUE --env BLENDER_MCP_INLINE_IMAGE_PX=YOUR_VALUE --env BLENDER_MCP_MAX_CONCURRENCY=YOUR_VALUE --env THREE_WS_BASE=YOUR_VALUE --env THREE_WS_FORGE_TIMEOUT_MS=YOUR_VALUE --env THREE_WS_FORGE_PROVIDER_KEY=YOUR_VALUE io-github-nirholas-blender-mcp -- npx -y @three-ws/blender-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-nirholas-blender-mcp]
command = "npx"
args = ["-y","@three-ws/blender-mcp"]

[mcp_servers.io-github-nirholas-blender-mcp.env]
BLENDER_PATH = "YOUR_VALUE"
BLENDER_MCP_TIMEOUT_MS = "YOUR_VALUE"
BLENDER_MCP_WORKDIR = "YOUR_VALUE"
BLENDER_MCP_ALLOW_PYTHON = "YOUR_VALUE"
BLENDER_MCP_INLINE_IMAGE_BYTES = "YOUR_VALUE"
BLENDER_MCP_INLINE_IMAGE_PX = "YOUR_VALUE"
BLENDER_MCP_MAX_CONCURRENCY = "YOUR_VALUE"
THREE_WS_BASE = "YOUR_VALUE"
THREE_WS_FORGE_TIMEOUT_MS = "YOUR_VALUE"
THREE_WS_FORGE_PROVIDER_KEY = "YOUR_VALUE"
```
需要环境变量：BLENDER_PATH, BLENDER_MCP_TIMEOUT_MS, BLENDER_MCP_WORKDIR, BLENDER_MCP_ALLOW_PYTHON, BLENDER_MCP_INLINE_IMAGE_BYTES, BLENDER_MCP_INLINE_IMAGE_PX, BLENDER_MCP_MAX_CONCURRENCY, THREE_WS_BASE, THREE_WS_FORGE_TIMEOUT_MS, THREE_WS_FORGE_PROVIDER_KEY

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-nirholas-blender-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/blender-mcp"
      ],
      "env": {
        "BLENDER_PATH": "YOUR_VALUE",
        "BLENDER_MCP_TIMEOUT_MS": "YOUR_VALUE",
        "BLENDER_MCP_WORKDIR": "YOUR_VALUE",
        "BLENDER_MCP_ALLOW_PYTHON": "YOUR_VALUE",
        "BLENDER_MCP_INLINE_IMAGE_BYTES": "YOUR_VALUE",
        "BLENDER_MCP_INLINE_IMAGE_PX": "YOUR_VALUE",
        "BLENDER_MCP_MAX_CONCURRENCY": "YOUR_VALUE",
        "THREE_WS_BASE": "YOUR_VALUE",
        "THREE_WS_FORGE_TIMEOUT_MS": "YOUR_VALUE",
        "THREE_WS_FORGE_PROVIDER_KEY": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-nirholas-blender-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0aHJlZS13cy9ibGVuZGVyLW1jcCJdLCJlbnYiOnsiQkxFTkRFUl9QQVRIIjoiWU9VUl9WQUxVRSIsIkJMRU5ERVJfTUNQX1RJTUVPVVRfTVMiOiJZT1VSX1ZBTFVFIiwiQkxFTkRFUl9NQ1BfV09SS0RJUiI6IllPVVJfVkFMVUUiLCJCTEVOREVSX01DUF9BTExPV19QWVRIT04iOiJZT1VSX1ZBTFVFIiwiQkxFTkRFUl9NQ1BfSU5MSU5FX0lNQUdFX0JZVEVTIjoiWU9VUl9WQUxVRSIsIkJMRU5ERVJfTUNQX0lOTElORV9JTUFHRV9QWCI6IllPVVJfVkFMVUUiLCJCTEVOREVSX01DUF9NQVhfQ09OQ1VSUkVOQ1kiOiJZT1VSX1ZBTFVFIiwiVEhSRUVfV1NfQkFTRSI6IllPVVJfVkFMVUUiLCJUSFJFRV9XU19GT1JHRV9USU1FT1VUX01TIjoiWU9VUl9WQUxVRSIsIlRIUkVFX1dTX0ZPUkdFX1BST1ZJREVSX0tFWSI6IllPVVJfVkFMVUUifX0
需要环境变量：BLENDER_PATH, BLENDER_MCP_TIMEOUT_MS, BLENDER_MCP_WORKDIR, BLENDER_MCP_ALLOW_PYTHON, BLENDER_MCP_INLINE_IMAGE_BYTES, BLENDER_MCP_INLINE_IMAGE_PX, BLENDER_MCP_MAX_CONCURRENCY, THREE_WS_BASE, THREE_WS_FORGE_TIMEOUT_MS, THREE_WS_FORGE_PROVIDER_KEY