重要提示：此项目已移至 https://github.com/autodesk-platform-services/aps-mcp-server-nodejs。

---

<br/> <br/> <br/> <br/> <br/> <br/> <br/> <br/>

aps-mcp-server

这是一个使用 Node.js 构建的实验性 Model Context Protocol 服务器，提供对 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 <用户名> <名字> <姓氏>，例如，npx create-service-account ssa-test-user John Doe
  • 此脚本将输出一系列环境变量，包含新账户的信息：
    • APS_SA_ID - 您的服务账户 ID
    • APS_SA_EMAIL - 您的服务账户电子邮件
    • APS_SA_KEY_ID - 您的服务账户密钥 ID
    • APS_SA_PRIVATE_KEY - 您的服务账户私钥
• 将这些环境变量添加到您的 .env 文件中

Autodesk Construction Cloud

• 注册您的 APS 应用客户端 ID 作为自定义集成
• 邀请服务账户电子邮件作为新成员加入您的 ACC 项目

使用 Inspector

• 运行 Model Context Protocol 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": [
                "/绝对路径/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

• 打开 Claude Desktop，并尝试以下测试提示：
  • 我可以访问哪些 ACC 项目？
  • 给我一个项目 XYZ 中所有问题的可视化仪表板

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

使用 Visual Studio Code & Copilot

• 确保您已在 Visual Studio Code 中 启用 MCP 服务器
• 在您的工作区创建 .vscode/mcp.json 文件，并向其中添加以下 JSON：

{
    "servers": {
        "Autodesk Platform Services": {
            "type": "stdio",
            "command": "node",
            "args": [
                "/绝对路径/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

更多关于如何将 MCP 服务器添加到 Visual Studio Code 的详细信息，请参阅 文档

使用 Cursor

• 在您的工作区创建 .cursor/mcp.json 文件，并向其中添加以下 JSON：

{
  "mcpServers": {
    "Autodesk Platform Services": {
      "command": "node",
      "args": [
        "/Users/brozp/Code/Temp/aps-mcp-server-node/build/server.js"
      ]
    }
  }
}

更多关于如何将 MCP 服务器添加到 Cursor 的详细信息，请参阅 文档