スペックルMCPサーバー

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

概要

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

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

Related MCP server: MCP Etherscan Server

インストール

前提条件

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

設定

このリポジトリをクローンします:
git clone https://github.com/bimgeek/speckle-mcp.git cd speckle-mcp
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セクションの「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"）