APS MCP Server

APS MCP サーバー

APS toolkit を介して Autodesk ACC API を統合する、最小構成の MCP サーバーです。

動画の概要

セットアップ

オプション 1：uv を使用（推奨）

1. uv がインストールされていない場合は、インストールします：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. .env.sample を .env にコピーし、認証情報を入力します：

   cp .env.sample .env
   

3. 仮想環境を作成して有効化します：

   uv venv
   # On Windows:
   .venv\Scripts\activate
   # On Unix or MacOS:
   source .venv/bin/activate
   

4. 依存関係をインストールします：

   uv pip install -r requirements.txt
   

5. MCP サーバーを実行します：

   python aps_dm_server.py
   

オプション 2：pip を使用

1. .env.sample を .env にコピーし、認証情報を入力します：

   cp .env.sample .env
   

2. 仮想環境を作成して有効化します：

   python -m venv .venv
   # On Windows:
   .venv\Scripts\activate
   # On Unix or MacOS:
   source .venv/bin/activate
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

4. MCP サーバーを実行します：

   python aps_dm_server.py
   

Claude Desktop との統合

この MCP サーバーを Claude Desktop で使用するには：

1. Claude Desktop がインストールされていることを確認します（Claude.ai からダウンロードできます）

2. Claude Desktop の設定ファイルを開きます：

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

   ファイルが存在しない場合は作成します。

3. 適切な設定を追加します：

   オプション A：仮想環境から Python を直接使用（最も確実）

   {
       "mcpServers": {
           "acc": {
               "command": "/ABSOLUTE/PATH/TO/YOUR/.venv/bin/python",
               "args": [
                   "/ABSOLUTE/PATH/TO/YOUR/aps_dm_server.py"
               ],
               "env": {
                   "PYTHONPATH": "/ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER"
               }
           }
       }
   }
   

   パスを環境とプロジェクトへの絶対パスに置き換えてください。

   オプション B：uv を使用

   {
       "mcpServers": {
           "acc": {
               "command": "/ABSOLUTE/PATH/TO/uv",
               "args": [
                   "--directory",
                   "/ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER",
                   "run",
                   "aps_dm_server.py"
               ]
           }
       }
   }
   

   ターミナルで which uv を実行して、uv への絶対パスを確認します。

4. ファイルを保存し、Claude Desktop を完全に再起動します

5. Claude Desktop にハンマーのアイコンが表示されたら、ACC ツールにアクセスできます

macOS 固有のセットアップ

macOS ユーザーは Claude Desktop との統合時にアクセス権の問題が発生することがあります：

1. アクセス権の問題：ログに Operation not permitted のようなエラーが表示される場合：

   • 「システム設定」→「プライバシーとセキュリティ」→「フルディスクアクセス」を開きます
   • 「+」ボタンをクリックして、ターミナルと Claude アプリケーションを追加します

2. 作業ディレクトリの問題：現在のディレクトリが存在しないというエラーが表示される場合：

   • 設定では常に絶対パスを使用します
   • アクセス制限が少ない場所（例：書類フォルダー）にプロジェクトを保存することを検討します

3. 正しい Python パスの確認：仮想環境の Python への正確なパスを取得するには：

   source .venv/bin/activate  # Activate your environment first
   which python  # Get the full path
   

4. トラブルシューティングのためのログ確認：

   tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
   

要件

• Python 3.11 以降
• requirements.txt に記載されている依存関係

システムアーキテクチャ

この MCP サーバーは、Claude AI と Autodesk APS プラットフォームをつなぐブリッジとして機能します。以下の図は、システム内のデータの流れを示しています：

1. Claude へのクエリによってツールの選択が開始されます
2. Claude がローカルサーバーに MCP リクエストを送信します
3. MCP サーバーが認証情報を使用して APS/ACC に接続します
4. データが Claude に戻り、Claude が結果を処理して整形します

利用可能なツール

MCP サーバーは以下のツールを公開します：

• get_hubs：利用可能なすべてのハブを取得します
• get_projects：ハブ内のすべてのプロジェクトを取得します
• get_project_files：プロジェクト内の特定のフォルダーにあるファイルを取得します
• get_versions：特定の項目のバージョン情報を取得します

トラブルシューティング

Claude Desktop との統合で問題が発生した場合：

1. サーバーが表示されない：

   • 設定ファイルの構文が正しいことを確認します（有効な JSON）
   • すべての箇所で絶対パスを使用します
   • Claude Desktop を完全に再起動します

2. アクセス権エラー：

   • ターミナルと Claude にフルディスクアクセスを許可します
   • uv を介さず、Python を直接使用してみます
   • 制限の少ない場所にプロジェクトを移動してみます

3. 環境エラー：

   • すべての依存関係がインストールされていることを確認します
   • 仮想環境内の Python への直接パスを使用してみます
   • .env ファイルに正しい Autodesk 認証情報が設定されていることを確認します

4. ログの確認：

   tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
   

5. 手動テスト： サーバーを直接実行して、正常に動作することを確認します：

   cd /path/to/your/project
   source .venv/bin/activate
   python aps_dm_server.py
   

OpenAI Agents SDK での使用

このプロジェクトには OpenAI Agents SDK との連携が含まれており、OpenAI エージェントで MCP サーバーを使用できます。

1. .env ファイルに OpenAI API キーが含まれていることを確認します。

   OPENAI_API_KEY=your_openai_api_key
   

2. 追加の依存関係をインストールします。

   uv pip install openai>=1.31.0
   

3. エージェントを実行します。

   python main_agent.py
   

これにより、Autodesk プロジェクトについてエージェントに質問できる対話型セッションが開始されます。

依存関係とライセンス

このプロジェクトでは、以下のオープンソースコンポーネントを使用しています。

• aps-toolkit - Autodesk Platform Services 用のライブラリ（GPL-3.0）
• mcp - マルチモーダル機能プロトコルの実装
• python-dotenv - 環境変数の管理
• openai および openai-agents - OpenAI との連携

このプロジェクトは、aps-toolkit の依存関係に従い、GNU General Public License v3.0 の下でライセンスされています。

免責事項

このソフトウェアは、明示的か黙示的かを問わず、いかなる種類の保証もなく「現状有姿」で提供されます。これはデモを目的としたプロトタイプにすぎません。このソフトウェアの使用によって生じる可能性のある損害や問題について、作者は一切責任を負いません。ご自身の責任でご使用ください。