bpy-dev/blender-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

97 stars 9 forks 품질 73 트렌드 8GPL-3.0

Repository Install

Blender Lab MCP의 독립적 향상된 배포: 독립형 BPY, 런타임 API 문서, 벤치마크 도구

개요

이 브랜치는 에이전트 블렌더 작업을 위한 향상된 Blender MCP 워크플로우를 패키지로 제공합니다. 업스트림의 라이브 Blender 애드온/서버 모델을 유지하며, 저장 파일/헤드리스 실행, 선택 가능한 명령줄 백엔드, 런타임 Blender Python API 조회, 서브프로세스/캡처 강화, 벤치마크 툴링을 추가합니다. 이 배포판은 Blender Lab의 Blender MCP 프로젝트의 수정된 배포판입니다. 실행-위험 모델에 대한 출처와 SECURITY.md 은 NOTICE.md 을 참조하세요. 공개 bpy.dev 웹사이트 자산은 별도의 저장소에 보관됩니다. 컴필레이션은 를 다룹니다. 비디오 내 "CLIP 정확성" 라벨은 를 의미합니다. 링크된 변경 불가능한 H.264 비디오는 848×464, 134.9초, 10,161,884바이트이며; SHA-256: 04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17. - _for_cli 도구는 라이브 Blender UI 세션 없이 새로운 하위 프로세스에서 .blend 파일을 처리합니다. - Blender 실행 백엔드 또는 독립형 bpy Python 백엔드를 BLENDER_MCP_CLI_BACKEND 사용합니다.

개요(AI 번역)

향상된 MCP 개발자 미리보기

이 브랜치는 에이전트 블렌더 작업을 위한 향상된 Blender MCP 워크플로우를 패키지로 제공합니다. 업스트림의 라이브 Blender 애드온/서버 모델을 유지하며, 저장 파일/헤드리스 실행, 선택 가능한 명령줄 백엔드, 런타임 Blender Python API 조회, 서브프로세스/캡처 강화, 벤치마크 툴링을 추가합니다.

이 배포판은 Blender Lab의 Blender MCP 프로젝트의 수정된 배포판입니다. 실행-위험 모델에 대한 출처와 SECURITY.md 은 NOTICE.md 를 참조하세요. 공개 bpy.dev 웹사이트 자산은 별도의 저장소에 보관됩니다.

블렌더벤치 결과

이 컴필레이션은 27개의 작업 / 270발의 탄환을 포함합니다. 비디오에 붙은 “클립 정확도” 라벨은 이미지 임베딩 코사인 유사성, 문자 그대로의 정확성이 아님. 링크된 불변 H.264 비디오는 848×464, 134.9초, 10,161,884바이트입니다; SHA-256: 04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17.

강화된 것은 무엇인가

저장된 파일 도구들: _for_cli 도구는 라이브 Blender UI 세션 없이 .blend 파일을 처리하여 신선한 하위 프로세스에서 작동합니다.
백엔드 선택: Blender 실행 백엔드 또는 독립형 bpy 파이썬 백엔드와 BLENDER_MCP_CLI_BACKEND를 사용하세요.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Blender MCP

Enhanced MCP developer preview

This branch packages an enhanced Blender MCP workflow for agentic Blender work. It keeps the upstream live Blender add-on/server model and adds saved-file/headless execution, selectable command-line backends, runtime Blender Python API lookup, subprocess/capture hardening, and benchmark tooling.

This is a modified distribution of Blender Lab’s Blender MCP project. See NOTICE.md for provenance and SECURITY.md for the execution-risk model. Public bpy.dev website assets will live in a separate repository.

BlenderBench result

The compilation covers 27 tasks / 270 rounds. Its on-video “CLIP accuracy” label means CLIP image-embedding cosine similarity, not literal accuracy. The linked immutable H.264 video is 848×464, 134.9 seconds, and 10,161,884 bytes; SHA-256: 04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17.

What is enhanced

Saved-file tools: _for_cli tools operate on .blend files in fresh subprocesses without requiring a live Blender UI session.
Backend selection: use a Blender executable backend or a standalone bpy Python backend with BLENDER_MCP_CLI_BACKEND.
Runtime API lookup: agents can query exact signatures, enums, defaults, and availability from the active Blender/bpy runtime instead of relying only on bundled docs.
Process isolation: command-line executions are bounded by explicit timeouts, output caps, compact JSON framing, and source-file overwrite checks. This is crash/process-state isolation, not an OS sandbox.
Benchmark tooling: deterministic token-efficiency tasks, exploratory creative comparison harnesses, and a portable model-neutral full-27 BlenderBench runner with pinned inputs and post-generation scoring.

Current publication status

Developer-preview cleanup is in progress. Before publishing, complete PUBLICATION_CHECKLIST.md, especially package naming, fresh-clone install smoke tests, and tracked-file secret scanning.

Overview

A lightweight MCP (Model Context Protocol) server for Blender. It offers a natural language interface with Blender’s Python API, improving access to documentation, and allowing users to explore and understand complex setups.

Read the documentation at blender.org/lab/mcp-server

The project is deliberately small, maintainable, and does no more than necessary. It has two components that communicate over a TCP socket:

A Blender add-on that runs inside Blender and executes live-scene requests.
An MCP server that runs as a separate process, launched by the

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/blender_mcp/mcp",
        "run",
        "blender-mcp"
      ],
      "env": {
        "BLENDER_MCP_CLI_BACKEND": "bpy",
        "BLENDER_MCP_BPY_PYTHON": "/absolute/path/to/python-with-bpy"
      }
    }
  }
}