Aps MCP Server

🚀 aps-mcp-server

aps-mcp-server 是一個實驗性的 模型上下文協議 服務端實現，採用 Node.js 構建。它提供了對 Autodesk 平臺服務 API 的訪問能力，並藉助新的 安全服務賬戶 特性實現了細粒度的訪問控制。

YouTube 視頻

🚀 快速開始

開發

🔍 先決條件

• Node.js
• APS 應用憑證（必須是 服務器到服務器 類型的應用）
• ACC 或 BIM360 的訪問權限配置

⚙️ 設置

1. 克隆此倉庫。
2. 安裝依賴：

yarn install

3. 構建 TypeScript 代碼：

yarn run build

4. 在項目根目錄下創建一個 .env 文件，並添加你的 APS 憑證：
   • APS_CLIENT_ID - 你的 APS 應用程序客戶端 ID
   • APS_CLIENT_SECRET - 你的 APS 應用程序客戶端密鑰
5. 創建一個新的服務賬戶：

npx create-service-account ssa-test-user John Doe

此腳本將輸出新創建的服務賬戶的電子郵件，以及一堆環境變量。 6. 將新的環境變量添加到 .env 文件中（如覆蓋現有變量）： - APS_SA_ID - 你的服務賬戶 ID - APS_SA_EMAIL - 你的服務賬戶電子郵件 - APS_SA_KEY_ID - 你的服務賬戶密鑰 ID - APS_SA_PRIVATE_KEY - 你的服務賬戶私有密鑰 7. 將服務賬戶的電子郵件邀請為你的 ACC 項目中的新成員。

💻 使用示例

與 Inspector 使用

1. 運行 模型上下文協議 Inspector：

yarn run inspect

2. 打開 http://localhost:5173。
3. 點擊 連接 開始此 MCP 服務端並連接到它。

與 Claude Desktop 使用

1. 確保安裝了 Claude Desktop。
2. 如果你還沒有，創建一個 Claude Desktop 配置文件（如果有的話）：
   • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json
3. 將此 MCP 服務端添加到配置中，使用你係統上 build/server.js 文件的絕對路徑，例如：

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

4. 打開 Claude Desktop，並嘗試以下測試提示之一：
   • 我有哪些可訪問的 ACC 項目？
   • 給我一個顯示項目 XYZ 中所有問題的可視化儀表盤。

💡 使用建議

更多關於如何將 MCP 服務端添加到 Claude Desktop，請參閱 官方文檔。