aps-mcp-server

实验性的 Model Context Protocol 服务器，使用 Node.js 构建，提供对 Autodesk Platform Services API 的访问，并通过新的 Secure Service Accounts 功能实现细粒度的访问控制。

开发

前提条件

• Node.js
• APS 应用凭证（必须是 Server-to-Server 应用类型）
• 在 ACC 或 BIM360 中配置访问权限

设置

• 克隆此仓库
• 安装依赖：yarn install
• 构建 TypeScript 代码：yarn run build
• 在此项目的根文件夹中创建一个 .env 文件，并添加您的 APS 凭证：
  • APS_CLIENT_ID - 您的 APS 应用客户端 ID
  • APS_CLIENT_SECRET - 您的 APS 应用客户端密钥
• 创建一个新的服务账户（我们称之为 test-account-1）：npx create-service-account test-account-1
  • 此脚本将输出新创建的服务账户的电子邮件地址和一些环境变量
• 将这些新的环境变量添加到或覆盖您的 .env 文件中的现有变量
  • APS_SA_ID - 您的服务账户 ID
  • APS_SA_EMAIL - 您的服务账户电子邮件
  • APS_SA_KEY_ID - 您的服务账户密钥 ID
  • APS_SA_PRIVATE_KEY - 您的服务账户私钥
• 邀请服务账户电子邮件作为新成员加入您的 ACC 项目

使用 Inspector

• 运行 Model Context Protocol Inspector：yarn run inspect
• 打开 http://localhost:5173
• 点击 Connect 以启动此 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 项目中所有问题的可视化仪表板

有关如何向 Claude Desktop 添加 MCP 服务器的更多详细信息，请参阅官方文档。