aps-mcp-server

这是一个实验性的 模型上下文协议 服务器，使用 Node.js 构建，提供对 Autodesk Platform Services API 的访问，并使用新的 安全服务帐户 功能进行细粒度的访问控制。

开发

前提条件

• Node.js
• APS 应用程序凭据 (必须是 服务器到服务器 应用程序类型)
• 已配置对 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 一起使用

• 运行 模型上下文协议 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 的更多详细信息，请参阅 官方文档。