模型上下文协议服务器

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

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 <username> <first name> <last name>例如， 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一起使用

• 跑吧 模型上下文协议检查器: yarn run inspect
• 打开http://localhost:5173
• 击打 Connect 启动此MCP服务器并连接到它

与Claude Desktop一起使用

• 确保你有 Claude桌面版 安装
• 如果您还没有Claude Desktop配置文件，请创建一个：
  • 在macOS上： ~/库/应用支持/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的更多详细信息，请参阅 官方文件.

与Visual Studio代码和副本一起使用

• 确保你有 在Visual Studio代码中启用MCP服务器
• 创建 .vcode/mcp.json 在您的工作区中创建一个文件，并向其中添加以下JSON：

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

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

与光标一起使用

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

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

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