Skip to main content
Glama

Speckle MCP Server

by bimgeek

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

{ "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 ファイルを参照してください。

-
security - not tested
F
license - not found
-
quality - not tested

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 共同データ ハブからプロジェクトの一覧表示/検索、モデル バージョンへのアクセス、オブジェクトとそのプロパティの取得/クエリを実行できます。

  1. 概要
    1. インストール
      1. 前提条件
      2. 設定
    2. 構成
      1. 環境変数
      2. MCP構成
    3. 利用可能なツール
      1. プロジェクト
      2. モデル
      3. オブジェクト
    4. トラブルシューティング
      1. ライセンス

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          Facilitates 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 -
          6
          15
          22
          TypeScript
          MIT License
        • A
          security
          A
          license
          A
          quality
          Provides 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 -
          6
          15
          1
          TypeScript
          MIT License
        • A
          security
          A
          license
          A
          quality
          A 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 -
          6
          721
          JavaScript
          MIT License
        • A
          security
          A
          license
          A
          quality
          It interacts with the Kaggle API to provide tools for searching and downloading datasets, and a prompt for generating EDA notebooks.
          Last updated -
          2
          19
          Python
          MIT License
          • Linux
          • Apple

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/bimgeek/speckle-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server