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.

Integrations

Provides a bridge to Speckle's AEC (Architecture, Engineering, Construction) tools, allowing users to list, search, and retrieve projects, access model versions, and query object properties from BIM data.

スペックルMCPサーバー

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

概要

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

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

インストール

前提条件

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"）

トラブルシューティング

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

ライセンス

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Speckle の API とクライアントアプリケーション間のブリッジであり、ユーザーは AEC ツール用の Speckle 共同データハブからプロジェクトの一覧表示/検索、モデルバージョンへのアクセス、オブジェクトとそのプロパティの取得/クエリを実行できます。

Appeared in Searches

How to create .docx documents for Microsoft Word