Speckle

🚀 Speckle 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  # 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セクションに「speckle」エントリを追加または更新します。

{
  "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_objects：タイプまたは属性でオブジェクトをフィルタリングします。
  • パラメータ：
    • type（オプション）：検索するオブジェクトのタイプ
    • properties（オプション）：含める属性のリスト
    • limit（オプション）：取得する最大オブジェクト数（デフォルト：20）

🔧 トラブルシューティング

• トークンが正しく設定されていることを確認し、適切な権限を持っていることを確認してください。
• サーバーログを確認して詳細な情報を取得してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。