aps-mcp-服务器

使用 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 一起使用

• 运行模型上下文协议检查器： 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 项目所有问题的可视化仪表板

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