Blender MCP 서버, Claude Code로 구축된 100개 이상의 도구 포함

한 개발자가 14개 카테고리에 걸쳐 100개 이상의 도구를 제공하는 Blender용 MCP 서버를 구축했습니다. 이를 통해 Claude Code, Claude Desktop, Cursor, Windsurf와 같은 AI 코딩 에이전트가 자연어 프롬프트로 Blender를 제어할 수 있습니다.

주요 기능

이 MCP 서버는 AI 에이전트가 조명, 모디파이어, 애니메이션, 셰이더 노드, 지오메트리 노드, 카메라, 렌더링 등 다양한 Blender 기능을 제어할 수 있게 합니다. 데모 영상에서는 빈 장면에서 완전히 조명이 설정되고 애니메이션이 적용된 Cycles 렌더링 장면까지 Claude Code의 자연어 프롬프트만으로 진행되는 과정을 보여줍니다.

Claude Code를 활용한 개발

전체 코드베이스는 Claude Code를 사용하여 작성되었습니다. 가장 중요한 아키텍처적 과제는 Blender의 모든 API 호출이 메인 스레드에서 이루어져야 한다는 요구사항이었습니다. Claude Code는 bpy.app.timers를 사용한 명령 큐가 있는 TCP 브리지를 설계하는 데 도움을 주었습니다. Claude는 실행 취소 작업, 파일 로드, 스크립트 재로드에서도 살아남는 지속적인 타이머 + 워치독 패턴을 찾아냈습니다.

Claude는 또한 지연 로딩 시스템을 제안했습니다: 100개 이상의 도구를 한 번에 로드하는 것은 비효율적이기 때문에, 처음에는 15개의 핵심 도구만 노출됩니다. AI는 list_tool_categories()와 enable_tools() 함수를 통해 필요에 따라 카테고리를 발견하고 활성화합니다.

기술적 과제와 해결책

가장 큰 과제는 Blender 애드온의 소켓 서버가 /clear 명령이나 컨텍스트 재설정 후에 종료되는 문제였습니다. 이전의 Modal Operator 접근 방식은 윈도우 이벤트에 의존적이었습니다. Claude Code는 연결 스레드에서 타이머를 자동으로 재시작하는 워치독이 있는 bpy.app.timers로 마이그레이션하는 데 도움을 주었습니다. 이는 여러 번의 반복이 필요했지만 안정적인 솔루션으로 이어졌습니다.

이 도구는 Blender 워크플로우에 AI 코딩 에이전트를 통합하고 싶은 개발자들을 위해 7일 무료 체험판으로 제공됩니다.