🚀 aps-mcp-server

aps-mcp-server 是一个实验性的 模型上下文协议 服务端实现，采用 Node.js 构建。它提供了对 Autodesk 平台服务 API 的访问能力，并借助新的 安全服务账户 特性实现了细粒度的访问控制。

YouTube 视频

🚀 快速开始

开发

🔍 先决条件

• Node.js
• APS 应用凭证（必须是 服务器到服务器 类型的应用）
• ACC 或 BIM360 的访问权限配置

⚙️ 设置

1. 克隆此仓库。
2. 安装依赖：

yarn install

3. 构建 TypeScript 代码：

yarn run build

4. 在项目根目录下创建一个 .env 文件，并添加你的 APS 凭证：
   • APS_CLIENT_ID - 你的 APS 应用程序客户端 ID
   • APS_CLIENT_SECRET - 你的 APS 应用程序客户端密钥
5. 创建一个新的服务账户：

npx create-service-account ssa-test-user John Doe

此脚本将输出新创建的服务账户的电子邮件，以及一堆环境变量。 6. 将新的环境变量添加到 .env 文件中（如覆盖现有变量）： - APS_SA_ID - 你的服务账户 ID - APS_SA_EMAIL - 你的服务账户电子邮件 - APS_SA_KEY_ID - 你的服务账户密钥 ID - APS_SA_PRIVATE_KEY - 你的服务账户私有密钥 7. 将服务账户的电子邮件邀请为你的 ACC 项目中的新成员。

💻 使用示例

与 Inspector 使用

1. 运行 模型上下文协议 Inspector：

yarn run inspect

2. 打开 http://localhost:5173。
3. 点击 连接 开始此 MCP 服务端并连接到它。

与 Claude Desktop 使用

1. 确保安装了 Claude Desktop。
2. 如果你还没有，创建一个 Claude Desktop 配置文件（如果有的话）：
   • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json
3. 将此 MCP 服务端添加到配置中，使用你系统上 build/server.js 文件的绝对路径，例如：

{
    "mcpServers": {
        "autodesk-platform-services": {
            "command": "node",
            "args": [
                "/absolute/path/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

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

💡 使用建议

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