Autodesk MCP

🚀 Autodesk Alias API - MCP Server

このMCP（Model Context Protocol）サーバーは、AIアシスタントがAutodesk Alias APIのドキュメントを検索可能にします。Claude DesktopやCursorなど、MCP互換のクライアントツール内で直接利用できます。

⚠️ 免責事項：これは非公式のコミュニティによって構築されたプロジェクトです。Autodesk Inc.とは関係がなく、承認もサポートもされていません。

🚀 クイックスタート

1. クローンと依存関係のインストール

   git clone https://github.com/Roshan-RB/Autodesk_MCP.git
   cd Autodesk_MCP
   pip install -r requirements.txt
   

2. AIツールへの接続 — サーバーをMCPクライアントの設定に追加します。

   {
     "mcpServers": {
       "autodesk-alias-docs": {
         "command": "/path/to/Autodesk_MCP/venv/Scripts/python.exe",
         "args": ["/path/to/Autodesk_MCP/run_server_v3.py"]
       }
     }
   }
   

   /path/to/Autodesk_MCP を実際のインストールパスに置き換えてください。

✨ 主な機能

動作原理

Autodesk Alias APIのドキュメントは、Autodeskの公式ヘルプサイトからスクレイピングされ、構造化されたJSONファイルとしてローカルに保存されています。サーバー起動時に、231のドキュメントページがすべて読み込まれ、不要なデータが削除されてメモリを節約し、高速で関連性順に検索できるBM25検索インデックスが構築されます。

利用可能なツール

サーバーは4つのツールを公開しており、すべてPydanticで入力が検証され、ツールの注釈が付けられ、オプションでJSON出力が可能です。

search_alias_docs(query, max_results, response_format)

BM25（Okapi）ランキングを使用してすべてのドキュメントを検索します。結果には関連性スコア、一致した用語、コンテンツのスニペットが含まれます。タイトルが完全に一致する場合やコードブロックがあるページにはヒューリスティックなブーストが適用されます。

例: search_alias_docs("create NURBS surface")
例: search_alias_docs("AlCurve", response_format="json")

get_doc_by_title(title)

タイトルでドキュメントページの完全なコンテンツを取得します（部分一致もサポート）。一致するものが見つからない場合は、タイトルの提案が返されます。

例: get_doc_by_title("AlCurve")

list_available_docs(limit, offset, category, response_format)

すべてのドキュメントページをページング表示します。カテゴリ（APIリファレンスの場合は class、チュートリアル/サンプルの場合は guide）でのフィルタリングをサポートし、ページネーションのメタデータ（has_more, next_offset）を返します。

例: list_available_docs(category="class", limit=20)
例: list_available_docs(offset=30, response_format="json")

get_code_examples(topic, max_results, response_format)

指定されたトピックに関するコード例を含むドキュメントページを検索します。検索結果をコードブロックがあるページのみに絞り込みます。サンプルプラグインやAPIの使用パターンを見つけるのに最適です。

例: get_code_examples("plug-in")
例: get_code_examples("NURBS", response_format="json")

MCPリソース

軽量なプログラムアクセス用の2つの読み取り専用リソースがあります。

• docs://index — すべてのページの完全なJSONインデックス（タイトル、GUID、URL、コードの有無、カテゴリ）
• docs://stats — コーパスの概要（総ページ数、クラス/ガイド/コードの数）

📚 ドキュメント

ドキュメントのカバレッジ

スクレイピングされたデータセットは231ページをカバーしており、以下の内容が含まれています。

• クラスリファレンス — AlCurve、AlSurface、AlDagNode、AlUniverseなど100以上のクラス
• プラグイン開発 — モーメンタリー、コンティニュアス、コマンド履歴プラグイン
• APIサンプル — 説明付きの完全なコード例
• 実装ガイド — プラグインのコンパイル、リンク、セットアップ

今後の予定

• 意味的検索 — BM25に基づく検索に埋め込みベースの検索を追加し、より文脈認識型の結果を得る
• 文脈ベースのツール選択 — ユーザーの意図に基づいてクエリをより賢くルーティングする
• プラグイン開発 — このMCPサーバーを利用した実際のAutodesk Aliasプラグインを構築する

このリポジトリは現在も積極的に開発されています。ぜひ注目してください。⭐

📄 ライセンス

このプロジェクトはAutodesk Aliasのドキュメントにアクセスするためのツールを提供しています。ドキュメントの内容自体は© Autodesk Inc.です。ドキュメントのライセンスについては、Autodeskの利用規約を参照してください。