Aps MCP Server

🚀 aps - mcp - server

これは実験的なモデルコンテキストプロトコルのサーバー実装です。Node.js を使用して構築され、Autodesk プラットフォーム サービス API へのアクセスを提供し、新しい セキュリティ サービス アカウント 機能を通じて細粒度のアクセス制御を実現します。

YouTube 動画

🚀 クイックスタート

✨ 主な機能

• モデルコンテキストプロトコルのサーバー実装を提供します。
• Node.js を使用して構築され、Autodesk プラットフォーム サービス API へのアクセスを可能にします。
• 新しいセキュリティ サービス アカウント機能により、細粒度のアクセス制御を実現します。

📦 インストール

前提条件

• Node.js
• APS アプリケーションの資格情報（サーバー間 タイプのアプリケーションである必要があります）
• ACC または BIM360 へのアクセス権の設定

セットアップ

• このリポジトリをクローンします。
• 依存関係をインストールします：yarn install
• TypeScript コードをビルドします：yarn run build
• プロジェクトのルート ディレクトリに .env ファイルを作成し、APS の資格情報を追加します：
  • APS_CLIENT_ID - あなたの APS アプリケーションのクライアント ID
  • APS_CLIENT_SECRET - あなたの APS アプリケーションのクライアント シークレット
• 新しいサービス アカウントを作成します：npx create-service-account ssa - test - user John Doe
  • このスクリプトは、新しく作成されたサービス アカウントのメールアドレスと、いくつかの環境変数を出力します。
• 新しい環境変数を .env ファイルに追加します（既存の変数を上書きする場合もあります）：
  • APS_SA_ID - あなたのサービス アカウント ID
  • APS_SA_EMAIL - あなたのサービス アカウントのメールアドレス
  • APS_SA_KEY_ID - あなたのサービス アカウントのキー ID
  • APS_SA_PRIVATE_KEY - あなたのサービス アカウントの秘密鍵
• サービス アカウントのメールアドレスをあなたの ACC プロジェクトの新しいメンバーとして招待します。

💻 使用例

基本的な使用法

Inspector との使用方法

• モデルコンテキストプロトコル Inspector を実行します：yarn run inspect
• http://localhost:5173 を開きます。
• 接続 をクリックして、この MCP サーバーを起動し、接続します。

Claude Desktop との使用方法

• Claude Desktop がインストールされていることを確認します。
• まだ作成していない場合は、Claude Desktop の設定ファイルを作成します（存在する場合）：
  • macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows の場合：%APPDATA%\Claude\claude_desktop_config.json
• この MCP サーバーを設定に追加します。システム上の build/server.js ファイルの絶対パスを使用します。例えば：

{
    "mcpServers": {
        "autodesk-platform-services": {
            "command": "node",
            "args": [
                "/absolute/path/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

• Claude Desktop を開き、以下のテスト プロンプトのいずれかを試してみます：
  • アクセス可能な ACC プロジェクトはどれですか？
  • プロジェクト XYZ のすべての問題を表示するビジュアル ダッシュボードを作成してください。

詳細については、公式ドキュメント を参照してください。