スペックルMCPサーバー
AEC ツールに接続する共同データ ハブである Speckle と対話するためのモデル コンテキスト プロトコル (MCP) サーバー。
概要
この MCP サーバーは、Speckle の API とクライアント アプリケーション間のブリッジとして機能し、ユーザーが次の操作を実行できる一連のツールを公開します。
- Speckleプロジェクトの一覧と検索
- 詳細なプロジェクト情報を取得する
- プロジェクト内のモデルバージョンにアクセスする
- 特定のバージョンからオブジェクトとそのプロパティを取得および照会する
インストール
前提条件
- Python 3.13以上
- 個人アクセストークンを持つSpeckleアカウント
- 依存関係管理と仮想環境のための uv
設定
- このリポジトリをクローンします:
- Python 3.13 がインストールされていることを確認してください。
- uv を使用して依存関係をインストールします。
構成
環境変数
サーバーには次の環境変数が必要です。
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プロジェクトのIDlimit
(オプション): 取得するモデルの最大数 (デフォルト: 20)
- パラメータ:
search_projects
: 名前または説明でプロジェクトを検索します- パラメータ:
query
: プロジェクト名と説明で検索する用語
- パラメータ:
モデル
get_model_versions
: 特定のモデルのすべてのバージョンを一覧表示します- パラメータ:
project_id
: SpeckleプロジェクトのIDmodel_id
: バージョンを取得するモデルのIDlimit
(オプション): 取得するバージョンの最大数 (デフォルト: 20)
- パラメータ:
オブジェクト
get_version_objects
: 特定のバージョンからオブジェクトを取得します- パラメータ:
project_id
: SpeckleプロジェクトのIDversion_id
: オブジェクトを取得するバージョンのIDinclude_children
(オプション): レスポンスに子オブジェクトを含めるかどうか (デフォルト: false)
- パラメータ:
query_object_properties
: バージョン内のオブジェクトから特定のプロパティを照会します- パラメータ:
project_id
: SpeckleプロジェクトのIDversion_id
: オブジェクトを取得するバージョンのIDproperty_path
: プロパティへのドット表記パス(例: "elements.0.name")
- パラメータ:
トラブルシューティング
- 認証の問題が発生した場合は、Speckleトークンが有効であり、必要な権限があることを確認してください。
- 詳細なエラーメッセージについてはサーバーログを確認してください
- MCP構成で環境変数が正しく設定されていることを確認します
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
This server cannot be installed
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.
Speckle の API とクライアント アプリケーション間のブリッジであり、ユーザーは AEC ツール用の Speckle 共同データ ハブからプロジェクトの一覧表示/検索、モデル バージョンへのアクセス、オブジェクトとそのプロパティの取得/クエリを実行できます。
Related MCP Servers
- AsecurityAlicenseAqualityFacilitates interaction with Ethereum blockchain data via Etherscan's API, providing real-time access to balances, transactions, token transfers, contract ABIs, gas prices, and ENS name resolutions.Last updated -61522TypeScriptMIT License
- AsecurityAlicenseAqualityProvides Ethereum blockchain data tools via Etherscan's API, enabling users to check ETH balances, view transactions, track token transfers, fetch contract ABIs, monitor gas prices, and resolve ENS names.Last updated -6151TypeScriptMIT License
- AsecurityAlicenseAqualityA tool that enables users to interact with blockchain data to retrieve token total supply, chain IDs, and filtered RPC endpoints across different blockchain networks.Last updated -6721JavaScriptMIT License
- AsecurityAlicenseAqualityIt interacts with the Kaggle API to provide tools for searching and downloading datasets, and a prompt for generating EDA notebooks.Last updated -219PythonMIT License