Blender MCP Server

블렌더 MCP 서버

Blender 스크립트를 관리하고 실행하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

• Blender Python 스크립트 추가, 편집, 실행 및 제거
• 헤드리스 Blender 환경에서 스크립트 실행
• 실행 결과 및 오류 보기
• 스크립트 메타데이터 추적(생성 날짜, 마지막 수정 날짜, 실행 횟수)

요구 사항

• 파이썬 3.7 이상
• 블렌더 설치 및 접근 가능
• MCP 라이브러리( pip install mcp )

용법

1. 서버를 시작합니다:지엑스피1
2. MCP 클라이언트(Claude Desktop 등)를 사용하여 서버에 연결합니다.
3. 제공된 도구를 사용하여 스크립트를 관리하세요.
   • add_script(name, content) - 새 스크립트 추가
   • edit_script(name, content) - 기존 스크립트 편집
   • execute_script(name, blend_file=None) - Blender에서 스크립트를 실행하며, 선택적으로 .blend 파일을 지정합니다.
   • remove_script(name) - 스크립트 제거
4. 정보를 얻을 수 있는 리소스에 접속하세요:
   • scripts://list - 사용 가능한 스크립트 목록 가져오기
   • script://{name} - 특정 스크립트의 내용을 가져옵니다.
   • result://{name} - 스크립트 실행 결과 가져오기

예시

기본 예제

블렌드 파일 작업

작동 원리

1. 스크립트가 추가되면 script_files/scripts 디렉토리에 저장됩니다.
2. 스크립트가 실행되면 헤드리스 Blender 인스턴스에서 실행됩니다.
   • 블렌드 파일이 지정된 경우 Blender는 스크립트를 실행하기 전에 해당 파일을 엽니다.
   • 그렇지 않으면 기본 빈 Blender 장면이 사용됩니다.
3. 출력 및 오류는 script_files/results 디렉토리에 캡처되어 저장됩니다.
4. 스크립트에 대한 메타데이터는 script_files/metadata.json 에서 추적됩니다.

설치

1. 이 저장소를 복제하세요
2. MCP 라이브러리를 설치하세요: pip install mcp
3. Blender가 설치되어 PATH에서 접근 가능한지 확인하세요.

특허

MIT