aps-aecdm-mcp-dotnet

aps-aecdm-mcp-dotnet

Claude Desktop、AEC Data Model API、Viewer に接続する .NET MCP サーバーです。

はじめに

このサンプルは、Autodesk Platform Accelerators のプログラムのひとつで課題として提示された、新しい Model Context Protocol を使った実験として始まりました。この課題を提示し、このリポジトリで紹介するソリューションの実現に貢献してくださった Mirco Bianchini に、特別な感謝を申し上げます。

前提条件

このサンプルを動作させるには、次の作業が必要です。

• Claude Desktop をダウンロードしてインストールする
• このリポジトリをクローンまたはダウンロードする
• このプロジェクトをビルドする
• Claude の設定ファイル（開発者向けリソース）に .csproj への参照を追加する

デモ動画はこちら

仕組み

このサンプルでは、ModelContextProtocol .NET SDK を使用して MCP サーバーを作成します。

このサンプルでは、サーバーに次の 7 つの主要なツールを追加しました。

1. GetToken：APS API リクエストで使用する PKCE トークンを取得します。
2. GetHubs：AEC Data Model API を使用してハブを取得します。
3. GetProjects：AEC Data Model API を使用してプロジェクトを取得します。
4. GetElementGroupsByProject：AEC Data Model API を使用して ElementGroup を取得します。
5. GetElementsByElementGroupWithCategoryFilter：カテゴリフィルターを使用して、1 つの ElementGroup から要素を取得します。
6. RenderModel：Viewer を使用して設計をレンダリングします。
7. HighLightElements：Viewer で要素をハイライト表示します。

これらのツールを使用すると、AEC Data Model API を通じて、自然言語で ElementGroup のデータをクエリできます。

これは、この新しいプロトコルを使った最初の実験です。機能を改善できるよう、ぜひ提案をお寄せいただき、このリポジトリへの協力をお願いします。

セットアップ

ローカルでの実行

このプロジェクトをクローンまたはダウンロードしてください。GitHub desktop のインストールをおすすめします。コマンドラインでクローンするには、次のコマンドを使用してください（MacOSX/Linux では Terminal、Windows では Git Shell を使用します）。

git clone https://github.com/joaomartins-callmejohn/aps-aecdm-mcp-dotnet

Visual Studio（Windows）：

client_id を独自のキー（シングルページアプリケーション）に置き換えてください。 'Properties/lauchSettings.json' ファイルを直接編集するか、Visual Studio UI のデバッグプロパティから設定できます。

claude_desktop_congif.json ファイルに MCP サーバーへの参照を追加する必要があります。

{
    "mcpServers": {
      "aecdm": {
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "C:\\Users\\...mcp-server-aecdm.csproj",
                "--no-build"
            ]
        }
    }
}

さらに読む

トラブルシューティング

1. ハブが見つからない場合：Forma for Construction のハブで APS アプリをプロビジョニングする

2. コードを変更して、その内容を Claude に反映したい場合は、ソリューションを再ビルドする前に CLaude のタスクを終了する必要があります。

ライセンス

このサンプルは、MIT License の条件に基づいてライセンスされています。詳しくは、LICENSE ファイルをご覧ください。

執筆者

João Martins in/jpornelas