スペックルMCPサーバー

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

概要

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

• Speckleプロジェクトの一覧と検索

• 詳細なプロジェクト情報を取得する

• プロジェクト内のモデルバージョンにアクセスする

• 特定のバージョンからオブジェクトとそのプロパティを取得および照会する

Related MCP server: MCP Etherscan Server

インストール

前提条件

• 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」エントリを追加または更新します。

{
  "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 (オプション): レスポンスに子オブジェクトを含めるかどうか (デフォルト: false)

• query_object_properties : バージョン内のオブジェクトから特定のプロパティを照会します

  • パラメータ:

    • project_id : SpeckleプロジェクトのID

    • version_id : オブジェクトを取得するバージョンのID

    • property_path : プロパティへのドット表記パス（例： "elements.0.name"）

トラブルシューティング

• 認証の問題が発生した場合は、Speckleトークンが有効であり、必要な権限があることを確認してください。

• 詳細なエラーメッセージについてはサーバーログを確認してください

• MCP構成で環境変数が正しく設定されていることを確認します

ライセンス

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