aps-mcp-server

实验性的 模型上下文协议 服务端实现，使用 Node.js 构建，提供对 Autodesk 平台服务 API 的访问，并通过新的 安全服务账户 特性实现细粒度的访问控制。

YouTube 视频

开发

先决条件

• 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 中所有问题的可视化仪表盘

更多关于如何将 MCP 服务端添加到 Claude Desktop，请参阅 官方文档。