Blender Mcp 100/100 — SaferSkills

Is Blender Mcp safe to install?

SaferSkills independently audited Blender Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

README.md · 1 file

README.md10.1 KB · Markdown

<img src="docs/assets/logo.jpg" alt="Blender MCP Logo" width="480"> Control Blender with AI through the Model Context Protocol

<a href="#quick-start">Quick Start</a> • <a href="docs/en/ARCHITECTURE.md">Architecture</a> • <a href="docs/en/API_REFERENCE.md">API Reference</a> • <a href="docs/en/CONTRIBUTING.md">Contributing</a> • <a href="https://github.com/harveyxiacn/blender-mcp/discussions">Discussions</a> • <a href="#中文">中文</a>

Overview

Blender MCP is an open-source Model Context Protocol server that lets AI assistants control Blender through natural language. It works with any MCP-compatible client — Cursor, Windsurf, Claude Desktop, and more.

The project consists of two components:

MCP Server (src/blender_mcp/) — a FastMCP server exposing Blender operations as MCP tools
Blender Addon (addon/blender_mcp_addon/) — a Blender plugin that receives commands over TCP and executes them via Blender's Python API

AI Client (Cursor / Windsurf / Claude Desktop)
    ↓  MCP protocol (stdio or HTTP)
Blender MCP Server (Python, FastMCP)
    ↓  TCP JSON messages (localhost:9876)
Blender Addon (runs inside Blender)
    ↓  Blender Python API (bpy)
Blender

Gallery

All renders below were generated entirely through AI commands using Blender MCP — no manual Blender interaction.

Anime Character Trio	Fantasy Warrior
SAO Characters	Fantasy Warrior

Style Preview	Action Pose
Style Figure	Action

Key Features

359 MCP tools across 51 modules — modeling, materials, animation, rendering, rigging, and more
Smart skill loading — default skill profile starts with 32 tools; 12 skill groups activate on demand to keep AI context lean
6 profiles — from minimal (29 tools) to full (356 tools)
Visual feedback — blender_snapshot_viewport and blender_snapshot_render_preview for multimodal AI review loops
Checkpoint system — named save/restore points before risky operations
Style system — 8 rendering style presets from Pixel Art to AAA
67 procedural materials — metals, woods, stones, fabrics, nature, skin, effects, toon
Quality audit — topology, UV, and performance validation
Blender 4.x / 5.x compatible
Multi-IDE support — Cursor, Windsurf, Claude Desktop, and any MCP client

Quick Start

Prerequisites

Python 3.10+
Blender 4.0+
[uv](https://docs.astral.sh/uv/) (recommended) or pip
An MCP-compatible client

Install & Run

git clone https://github.com/harveyxiacn/blender-mcp.git
cd blender-mcp
uv sync

# Build the Blender addon
python build_addon.py

# Start the MCP server
uv run blender-mcp

Or install from PyPI:

pip install blender-mcp
blender-mcp

Set Up Blender

Open Blender → Edit → Preferences → Add-ons → Install...
Select dist/blender_mcp_addon.zip
Enable Blender MCP
Open the MCP panel in the 3D View sidebar

Configure Your IDE

Add to your MCP client config:

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/blender-mcp", "blender-mcp"]
    }
  }
}

Tool Profiles

Profile	Tools	Use Case
`minimal`	29	Core scene/object/utility/export only
`skill`	32	Default — core + on-demand skill loading
`focused`	108	Curated workflow set
`standard`	165	Broader daily-use coverage
`extended`	194	Adds physics & batch operations
`full`	356	Everything

Skill System

With the default skill profile, only core tools load at startup. AI activates additional groups on demand:

blender_list_skills         → see all 12 available skill groups
blender_activate_skill      → load a group's tools dynamically
blender_deactivate_skill    → unload to free AI context

Skills include: modeling, materials, style, character, animation, scene_setup, automation, physics, batch_assets, advanced_3d, sport_character, training.

Documentation

All documentation is available in English and 中文 (Chinese).

Document	English	中文
Quick Start	QUICKSTART	快速开始
Installation	INSTALLATION	安装指南
Architecture	ARCHITECTURE	架构设计
API Reference	API_REFERENCE	API 参考
Skill System	MCP_SKILL_SYSTEM_GUIDE	Skill 系统指南
Tutorials	TUTORIALS	教程
Contributing	CONTRIBUTING	贡献指南
Changelog	CHANGELOG	更新日志
Roadmap	ROADMAP	路线图
Security	SECURITY	安全策略
Code of Conduct	CODE_OF_CONDUCT	行为准则

Community

[Discord](https://discord.gg/rurjWE45) — live chat, help, and show & tell
[GitHub Discussions](https://github.com/harveyxiacn/blender-mcp/discussions) — questions, ideas, long-form discussion
[Issues](https://github.com/harveyxiacn/blender-mcp/issues) — bug reports and feature requests
[Contributing Guide](docs/en/CONTRIBUTING.md) — how to add tools, fix bugs, improve docs

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Fork the repo & create a feature branch
Install dev dependencies: uv sync --all-extras
Make changes and add tests
Run checks: pytest && ruff check src/ && black --check src/
Submit a pull request

Security

For security concerns, please see SECURITY.md. Do not open a public issue for security vulnerabilities.

Known Caveats

If .venv breaks after copying the repo to another machine, delete .venv and re-run uv sync

License

中文

概述

Blender MCP 是一个开源的 Model Context Protocol 服务器，让 AI 助手可以通过自然语言控制 Blender。支持 Cursor、Windsurf、Claude Desktop 等任意 MCP 兼容客户端。

展示

以下所有渲染结果完全通过 AI 命令生成，无需手动操作 Blender。

动漫角色三人组	奇幻战士
SAO 角色	奇幻战士

核心特性

359 个 MCP 工具，覆盖建模、材质、动画、渲染等全流程
智能工具加载 — 默认 skill 配置仅加载 32 个工具，12 个技能组按需激活
6 种配置方案 — 从 minimal（29 个工具）到 full（356 个工具）
视觉反馈 — 视口截图 + 渲染预览，支持多模态 AI 审查循环
检查点系统 — 高风险操作前的命名存档/还原点
风格系统 — 8 种渲染风格预设（像素风到 3A 级）
67 种程序化材质 — 金属、木材、石材、布料、自然、皮肤、特效、卡通
质量审计 — 拓扑、UV、性能验证
兼容 Blender 4.x / 5.x

快速开始

git clone https://github.com/harveyxiacn/blender-mcp.git
cd blender-mcp
uv sync

# 打包 Blender 插件
python build_addon.py

# 启动 MCP 服务器
uv run blender-mcp

或通过 pip 安装：

pip install blender-mcp
blender-mcp

然后在 Blender 中：

编辑 → 偏好设置 → 插件 → 安装...
选择 dist/blender_mcp_addon.zip
启用 Blender MCP
在 3D 视图侧边栏打开 MCP 面板

IDE 配置：

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/blender-mcp", "blender-mcp"]
    }
  }
}

社区

[Discord](https://discord.gg/rurjWE45) — 实时交流、使用帮助、作品展示
[GitHub Discussions](https://github.com/harveyxiacn/blender-mcp/discussions) — 提问、讨论、展示作品
[Issues](https://github.com/harveyxiacn/blender-mcp/issues) — 问题反馈与功能建议

Blender Mcp— agent skill

Is Blender Mcp safe to install?

Overview

Gallery

Key Features

Quick Start

Prerequisites

Install & Run

Set Up Blender

Configure Your IDE

Tool Profiles

Skill System

Documentation

Community

Contributing

Security

Known Caveats

License

中文

概述

展示

核心特性

快速开始

社区

文档

系统要求

许可证

Audit the pieces. Scan the whole. Decide.