스펙클 MCP 서버

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

개요

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

• Speckle 프로젝트 목록 및 검색

• 자세한 프로젝트 정보 검색

• 프로젝트 내에서 모델 버전에 액세스

• 특정 버전에서 개체와 해당 속성을 검색하고 쿼리합니다.

Related MCP server: MCP Etherscan Server

설치

필수 조건

• Python 3.13 이상

• 개인 액세스 토큰이 있는 Speckle 계정

• 종속성 관리 및 가상 환경을 위한 uv

설정

1. 이 저장소를 복제하세요:

   지엑스피1

2. Python 3.13이 설치되어 있는지 확인하세요.

   python --version  # Should show Python 3.13.x

3. 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.