Speckle MCP Server

スペックルMCPサーバー

AEC ツールに接続する共同データ ハブである Speckle と対話するためのモデル コンテキスト プロトコル (MCP) サーバー。

概要

この MCP サーバーは、Speckle の API とクライアント アプリケーション間のブリッジとして機能し、ユーザーが次の操作を実行できる一連のツールを公開します。

• Speckleプロジェクトの一覧と検索
• 詳細なプロジェクト情報を取得する
• プロジェクト内のモデルバージョンにアクセスする
• 特定のバージョンからオブジェクトとそのプロパティを取得および照会する

インストール

前提条件

• Python 3.13以上
• 個人アクセストークンを持つSpeckleアカウント
• 依存関係管理と仮想環境のための uv

設定

1. このリポジトリをクローンします:
   git clone https://github.com/bimgeek/speckle-mcp.git cd speckle-mcp
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セクションの「specke」エントリを追加または更新します。

/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 (オプション): レスポンスに子オブジェクトを含めるかどうか (デフォルト: false)
• query_object_properties : バージョン内のオブジェクトから特定のプロパティを照会します
  • パラメータ:
    • project_id : SpeckleプロジェクトのID
    • version_id : オブジェクトを取得するバージョンのID
    • property_path : プロパティへのドット表記パス（例： "elements.0.name"）

トラブルシューティング

• 認証の問題が発生した場合は、Speckleトークンが有効であり、必要な権限があることを確認してください。
• 詳細なエラーメッセージについてはサーバーログを確認してください
• MCP構成で環境変数が正しく設定されていることを確認します

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。