Blender MCP 서버

API를 통한 완벽한 Blender 제어를 위한 모델 컨텍스트 프로토콜(MCP) 서버

이 애드온은 Blender를 MCP 서버로 변환하여, AI 에이전트가 HTTP 엔드포인트를 통해 오케스트레이션할 수 있는 50개 이상의 강력한 도구를 제공합니다. AI 기반 3D 워크플로우, 자동화 및 창의적인 실험에 완벽합니다.

✨ 주요 기능

• 🚀 50개 이상의 도구 - Blender 기능에 대한 완벽한 제어:

  • 객체 생성, 조작 및 변형

  • 재질 및 셰이더 시스템 관리

  • 애니메이션 및 키프레임 제어

  • 카메라 및 조명 설정

  • 수정자(Modifier) 및 제약 조건(Constraint)

  • 물리 시뮬레이션 (강체, 천, 유체)

  • 지오메트리 노드 및 절차적 생성

  • 파일 가져오기/내보내기 작업

  • 장면 최적화 및 일괄 작업

• 🔒 스레드 안전 실행 - 안전한 동시 작업을 위한 엔터프라이즈급 큐 시스템

• 📦 자동 의존성 설치 - 첫 실행 시 필요한 패키지를 자동으로 설치

• 🎮 간편한 UI 패널 - Blender의 N-패널에서 클릭 한 번으로 서버 시작/중지

• 📊 실시간 모니터링 - 작업, 통계 및 서버 상태 추적

• 🔧 프로덕션 준비 완료 - 포괄적인 오류 처리, 로깅 및 캐싱

🚀 빠른 시작

설치

1. blender_mcp.py를 다운로드합니다.

2. Blender를 엽니다.

3. **Edit(편집) → Preferences(환경 설정) → Add-ons(애드온)**으로 이동합니다.

4. 검색창 옆의 드롭다운 화살표(⌄)를 클릭합니다.

5. **Install from Disk...(디스크에서 설치...)**를 선택합니다.

6. 다운로드한 blender_mcp.py 파일을 선택합니다.

7. "MCP Complete Server for Blender" 옆의 체크박스를 선택하여 애드온을 활성화합니다.

서버 시작

1. 3D 뷰포트에서 N을 눌러 사이드바를 엽니다.

2. MCP Server 탭으로 이동합니다.

3. Start Server를 클릭합니다.

4. 서버가 http://localhost:8000에서 시작됩니다.

애드온은 첫 실행 시 필요한 의존성(FastAPI, Uvicorn, Pydantic 등)을 자동으로 설치합니다.

🤖 PolyMCP와 함께 사용하기

이 MCP 서버는 AI 에이전트와 함께 MCP 서버를 오케스트레이션하기 위한 강력한 프레임워크인 **PolyMCP**와 원활하게 작동하도록 설계되었습니다.

예시: AI 제어 Blender

#!/usr/bin/env python3
import asyncio
from polymcp.polyagent import UnifiedPolyAgent, OllamaProvider

async def main():
    # Initialize your LLM provider
    llm = OllamaProvider(model="gpt-oss:120b-cloud", temperature=0.1)
    
    # Connect to Blender MCP server
    agent = UnifiedPolyAgent(
        llm_provider=llm, 
        mcp_servers=["http://localhost:8000/mcp"],  
        verbose=True
    )
    
    async with agent:
        print("✅ Blender MCP Server connected!\n")
        
        # Chat with your AI to control Blender
        while True:
            user_input = input("\n🎨 You: ")
            
            if user_input.lower() in ['exit', 'quit']:
                break
            
            result = await agent.run_async(user_input, max_steps=5)
            print(f"\n🤖 Blender: {result}")

if __name__ == "__main__":
    asyncio.run(main())

예시 명령

연결되면 AI 에이전트에게 다음과 같이 요청할 수 있습니다:

• "위치 (0, 0, 0)에 크기가 2인 큐브를 생성해줘"

• "선택한 객체에 빨간색 금속 재질을 추가해줘"

• "원점을 바라보는 카메라를 생성해줘"

• "3개의 조명이 있는 간단한 조명 장면을 설정해줘"

• "큐브에 유체 시뮬레이션을 추가해줘"

• "장면을 FBX 파일로 내보내줘"

• "100프레임 동안 객체를 360도 회전시키는 애니메이션을 만들어줘"

끝입니다! PolyMCP는 다음과 같은 모든 복잡한 작업을 처리합니다:

• 도구 검색 및 선택

• 다단계 작업 계획

• 오류 처리 및 재시도

• 작업 전반의 상태 관리

이를 통해 AI 기반 Blender 자동화 도구를 구축하는 것이 매우 간단해집니다!

📡 API 엔드포인트

서버가 실행되면 다음 항목에 액세스할 수 있습니다:

• API 문서: http://localhost:8000/docs

• 모든 도구 목록: http://localhost:8000/mcp/list_tools

• 도구 호출: POST http://localhost:8000/mcp/invoke/{tool_name}

🛠️ 사용 가능한 도구 카테고리

• 객체 작업: 객체 생성, 삭제, 복제, 선택

• 변형: 이동, 회전, 크기 조절, 변형 적용

• 재질 및 셰이딩: 재질 생성, 텍스처 추가, 셰이더 노드 설정

• 모델링: 수정자 추가, 불리언 작업, 메시 편집

• 애니메이션: 키프레임, 타임라인 제어, NLA 에디터

• 카메라 및 조명: 카메라 설정, 조명 생성, HDRI 환경

• 렌더링: 렌더 설정, 출력 구성, 렌더링

• 물리: 강체, 천, 유체 시뮬레이션

• 지오메트리 노드: 절차적 생성, 노드 트리 생성

• 파일 작업: 다양한 형식 가져오기/내보내기 (FBX, OBJ, USD 등)

• 장면 관리: 장면 정보, 정리, 최적화

• 일괄 작업: 다중 객체 생성 및 변형

• 고급: 파티클 시스템, 힘 필드, 그리스 펜슬

🔧 구성

blender_mcp.py의 Config 클래스를 편집하여 서버를 사용자 정의할 수 있습니다:

class Config:
    HOST = "0.0.0.0"           # Server host
    PORT = 8000                # Server port
    AUTO_INSTALL_PACKAGES = True  # Auto-install dependencies
    THREAD_SAFE_OPERATIONS = True  # Enable thread-safe execution
    ENABLE_CACHING = True      # Enable result caching

📋 요구 사항

애드온은 다음 의존성을 자동으로 설치합니다:

• FastAPI

• Uvicorn

• Pydantic

• docstring-parser

• NumPy

• PolyMCP

Blender 버전: 3.0.0 이상

🐛 문제 해결

서버가 시작되지 않나요?

• Blender의 시스템 콘솔에서 오류 메시지를 확인하세요 (Window → Toggle System Console)

• 포트 8000이 이미 사용 중인지 확인하세요

• 설치 후 Blender를 다시 시작해 보세요

의존성이 설치되지 않나요?

• Blender의 Python을 사용하여 패키지를 수동으로 설치하세요:

  /path/to/blender/python -m pip install fastapi uvicorn pydantic docstring-parser numpy

MCP Server 패널을 찾을 수 없나요?

• 3D 뷰포트에서 N을 누르세요

• 사이드바에서 "MCP Server" 탭을 찾으세요

• 환경 설정에서 애드온이 활성화되어 있는지 확인하세요

🤝 기여

기여를 환영합니다! 이 프로젝트는 PolyMCP를 위한 강력한 MCP 서버를 만드는 것이 얼마나 간단한지 보여줍니다.

📝 라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하세요

🔗 관련 프로젝트

• PolyMCP - 사용자 지정 에이전트를 사용하여 MCP 서버와 상호 작용하는 간단하고 효율적인 방법

• Model Context Protocol - LLM과의 도구 통합을 위한 개방형 프로토콜

💡 왜 이 프로젝트인가요?

이 MCP 서버는 PolyMCP가 AI 기반 도구를 구축하는 것을 얼마나 놀랍도록 간단하게 만드는지 보여주기 위해 만들어졌습니다. 단 몇 줄의 코드로 다음을 수행할 수 있습니다:

1. 복잡한 Blender 기능을 MCP 도구로 노출

2. AI 에이전트가 이러한 도구를 검색하고 오케스트레이션하도록 허용

3. 3D 생성을 위한 자연어 인터페이스 구축

복잡한 프롬프트, 수동 도구 선택, 상태 관리가 필요 없습니다. PolyMCP가 모든 것을 처리합니다!

PolyMCP를 위해 설계됨

유용하다고 생각되면 이 저장소에 별 ⭐을 눌러주세요!