SketchupMCP - Sketchup 모델 컨텍스트 프로토콜 통합

SketchupMCP는 Model Context Protocol(MCP)을 통해 Sketchup과 Claude AI를 연결하여 Claude가 Sketchup과 직접 상호 작용하고 제어할 수 있도록 합니다. 이러한 통합을 통해 Sketchup에서 즉각적인 3D 모델링, 장면 생성 및 조작이 가능해집니다.

영감과 구조를 제공해 준 Blender MCP 에 큰 박수를 보냅니다.

특징

• 양방향 통신 : TCP 소켓 연결을 통해 Claude AI를 Sketchup에 연결합니다.
• 구성 요소 조작 : Sketchup에서 구성 요소를 만들고, 수정하고, 삭제하고, 변형합니다.
• 재료 관리 : 재료 및 색상 적용 및 수정
• 장면 검사 : 현재 Sketchup 장면에 대한 자세한 정보를 얻으세요
• 선택 처리 : 선택된 구성 요소를 가져오고 조작합니다.
• Ruby 코드 평가 : 고급 작업을 위해 SketchUp에서 직접 임의의 Ruby 코드를 실행합니다.

구성 요소

이 시스템은 두 가지 주요 구성 요소로 구성됩니다.

1. Sketchup 확장 프로그램 : Sketchup 내에서 TCP 서버를 생성하여 명령을 수신하고 실행하는 Sketchup 확장 프로그램입니다.
2. MCP 서버( sketchup_mcp/server.py ) : 모델 컨텍스트 프로토콜을 구현하고 Sketchup 확장 프로그램에 연결하는 Python 서버

설치

파이썬 패키징

우리는 uv를 사용하고 있으므로 brew install uv 필요합니다.

스케치업 확장 프로그램

1. 최신 .rbz 파일을 다운로드하거나 빌드하세요
2. Sketchup에서 창 > 확장 관리자로 이동합니다.
3. "확장 프로그램 설치"를 클릭하고 다운로드한 .rbz 파일을 선택하세요
4. 스케치업을 다시 시작하세요

용법

연결 시작

1. Sketchup에서 확장 프로그램 > SketchupMCP > 서버 시작으로 이동합니다.
2. 서버는 기본 포트(9876)에서 시작됩니다.
3. 터미널에서 MCP 서버가 실행 중인지 확인하세요.

Claude와 함께 사용

Claude 구성에 다음을 추가하여 Claude가 MCP 서버를 사용하도록 구성하세요.

지엑스피1

이렇게 하면 PyPI에서 최신 정보를 가져올 수 있습니다.

연결되면 Claude는 다음 기능을 사용하여 Sketchup과 상호 작용할 수 있습니다.

도구

• get_scene_info - 현재 Sketchup 장면에 대한 정보를 가져옵니다.
• get_selected_components - 현재 선택된 구성 요소에 대한 정보를 가져옵니다.
• create_component - 지정된 매개변수로 새 구성 요소를 만듭니다.
• delete_component - 장면에서 구성 요소를 제거합니다.
• transform_component - 구성 요소를 이동, 회전 또는 크기 조정합니다.
• set_material - 구성 요소에 재료 적용
• export_scene - 현재 장면을 다양한 형식으로 내보냅니다.
• eval_ruby - 고급 작업을 위해 SketchUp에서 임의의 Ruby 코드 실행

예제 명령

클로드에게 요청할 수 있는 작업의 몇 가지 예는 다음과 같습니다.

• "지붕과 창문이 있는 간단한 집 모델을 만들어 보세요"
• "모든 구성 요소를 선택하고 해당 정보를 얻으세요"
• "선택한 구성 요소를 빨간색으로 만들기"
• "선택한 구성 요소를 10단위 위로 이동합니다"
• "현재 장면을 3D 모델로 내보내기"
• "Ruby 코드를 사용하여 복잡한 예술 및 공예 캐비닛 만들기"

문제 해결

• 연결 문제 : Sketchup 확장 서버와 MCP 서버가 모두 실행 중인지 확인하세요.
• 명령 실패 : Sketchup의 Ruby 콘솔에서 오류 메시지를 확인하세요.
• 시간 초과 오류 : 요청을 단순화하거나 더 작은 단계로 나누어보세요.

기술적 세부 사항

통신 프로토콜

이 시스템은 TCP 소켓을 통한 간단한 JSON 기반 프로토콜을 사용합니다.

• 명령은 type 과 선택적 params 포함하는 JSON 객체로 전송됩니다.
• 응답은 status 와 result 또는 message 포함하는 JSON 객체입니다.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT