remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides a bridge to Speckle's AEC (Architecture, Engineering, Construction) tools, allowing users to list, search, and retrieve projects, access model versions, and query object properties from BIM data.

스펙클 MCP 서버

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

개요

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

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

설치

필수 조건

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")

문제 해결

인증 문제가 발생하는 경우 Speckle 토큰이 유효하고 필요한 권한이 있는지 확인하세요.
자세한 오류 메시지는 서버 로그에서 확인하세요.
MCP 구성에서 환경 변수가 올바르게 설정되었는지 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Speckle API와 클라이언트 애플리케이션을 연결하는 브리지로, 사용자는 AEC 도구를 위한 Speckle 협업 데이터 허브에서 프로젝트를 나열/검색하고, 모델 버전에 액세스하고, 객체와 해당 속성을 검색/쿼리할 수 있습니다.

Appeared in Searches

How to create .docx documents for Microsoft Word