스펙클 MCP 서버

AEC 도구와 연결되는 협업 데이터 허브인 Speckle과 상호 작용하기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

개요

이 MCP 서버는 Speckle API와 클라이언트 애플리케이션 간의 브리지 역할을 하며 사용자가 다음을 수행할 수 있는 도구 세트를 제공합니다.

Speckle 프로젝트 목록 및 검색
자세한 프로젝트 정보 검색
프로젝트 내에서 모델 버전에 액세스
특정 버전에서 개체와 해당 속성을 검색하고 쿼리합니다.

Related MCP server: MCP Etherscan Server

설치

필수 조건

Python 3.13 이상
개인 액세스 토큰이 있는 Speckle 계정
종속성 관리 및 가상 환경을 위한 uv

설정

이 저장소를 복제하세요:
지엑스피1
Python 3.13이 설치되어 있는지 확인하세요.
python --version # Should show Python 3.13.x
uv를 사용하여 종속성을 설치합니다.
uv pip install -r requirements.txt

구성

환경 변수

서버에는 다음과 같은 환경 변수가 필요합니다.

SPECKLE_TOKEN : Speckle 개인 액세스 토큰(필수)
SPECKLE_SERVER : Speckle 서버 URL(기본값은 https://app.speckle.systems )

MCP 구성

이 서버를 Claude와 함께 사용하려면 MCP 구성 파일을 업데이트해야 합니다. 구성 파일은 일반적으로 다음 위치에 있습니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

mcpServers 섹션에 "speckle" 항목을 추가하거나 업데이트합니다.

{ "mcpServers": { "speckle": { "command": "uv", "args": [ "--directory", "/path/to/speckle-mcp", "run", "speckle_server.py" ], "env": { "SPECKLE_TOKEN": "YOUR_SPECKLE_API_TOKEN_HERE", "SPECKLE_SERVER": "https://app.speckle.systems" } } } }

/path/to/speckle-mcp speckle_mcp 패키지가 들어 있는 디렉토리의 실제 경로로 바꾸세요.

사용 가능한 도구

프로젝트

list_projects : 접근 가능한 모든 Speckle 프로젝트를 나열합니다.
- 매개변수:
  - limit (선택 사항): 검색할 최대 프로젝트 수(기본값: 20)
get_project_details : 특정 프로젝트에 대한 자세한 정보를 검색합니다.
- 매개변수:
  - project_id : 검색할 Speckle 프로젝트의 ID
  - limit (선택 사항): 검색할 최대 모델 수(기본값: 20)
search_projects : 이름이나 설명으로 프로젝트를 검색합니다.
- 매개변수:
  - query : 프로젝트 이름과 설명에서 찾을 검색어

모델

get_model_versions : 특정 모델의 모든 버전을 나열합니다.
- 매개변수:
  - project_id : Speckle 프로젝트의 ID
  - model_id : 버전을 검색할 모델의 ID
  - limit (선택 사항): 검색할 최대 버전 수(기본값: 20)

사물

get_version_objects : 특정 버전의 객체를 검색합니다.
- 매개변수:
  - project_id : Speckle 프로젝트의 ID
  - version_id : 객체를 검색할 버전의 ID
  - include_children (선택 사항): 응답에 children 객체를 포함할지 여부(기본값: false)
query_object_properties : 버전의 개체에서 특정 속성을 쿼리합니다.
- 매개변수:
  - project_id : Speckle 프로젝트의 ID
  - version_id : 객체를 검색할 버전의 ID
  - property_path : 속성에 대한 점 표기법 경로(예: "elements.0.name")