AI导哈

Autodesk平台服务MCP协议

ACC.MCP是一个基于Autodesk平台服务的模型上下文协议服务器，为AI助手（如Cursor）提供工具支持，包括项目管理、文件浏览和元数据查询等功能。

  • by EverseDevelopment
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 pabloderen/ACC.MCP

使用说明

ACC.MCP–Autodesk平台服务的MCP服务

MCP（模型上下文协议）服务器，公开 Autodesk平台服务（APS） 作为AI助手的工具（例如Cursor）。

需求

  • Node.js 18+
  • APS应用程序 随着 客户端ID 和 客户端密钥 （两条腿的OAuth）

设置

  1. 安装依赖项

    npm install

  2. 配置凭据

    复制 .env.example 到 .env 并设置您的APS应用程序凭据：

    cp .env.example .env
# Edit .env: set APS_CLIENT_ID and APS_CLIENT_SECRET

  3. 构建

    npm run build

  4. 包装（可选） 如果你想在Claude Desktop上使用它，你可以将MCP打包到.mcpb中

    npm run pack

运行MCP服务

服务器使用 标准 传输：客户端（例如Cursor）生成此进程，并通过stdin/stdout与之通信。

  • 直接运行： npm start 或 node dist/index.js
  • 使用env文件： 使用 dotenv 或加载您的外壳 .env 开始前

光标配置

在Cursor中添加此MCP服务器（例如。 设置→ MCP 或 .cursor/mcp.json):

{
  "mcpServers": {
    "acc-mcp": {
      "command": "node",
      "args": ["c:/repositories/00-Research/ACC.MCP/dist/index.js"],
      "env": {
        "APS_CLIENT_ID": "your_client_id",
        "APS_CLIENT_SECRET": "your_client_secret",
        "APS_SCOPE": "data:read"
      }
    }
  }
}

使用路径 dist/index.js 这与你的机器相匹配。你也可以通过 npx 或加载的包装器脚本 .env 然后跑 node dist/index.js.

工具

简化工具（推荐）

这些返回紧凑的预处理摘要（比原始API响应小约95%），并包括参数验证和有用的错误消息。

工具 说明
aps_list_hubs 列出所有ACC/BIM 360集线器（帐户）——返回名称、id、类型、地区。
aps_list_projects 列出中心中的项目——返回名称、id、平台、上次修改时间。
aps_get_top_folders 获取项目的根文件夹（项目文件、计划、共享等）。
aps_get_folder_contents 总结文件夹列表，包括文件类型细分、大小、版本信息。支持按扩展名过滤和隐藏隐藏项。
aps_get_item_details 单个文件的元数据：名称、类型、大小、版本号、日期。
aps_get_folder_tree 递归文件夹树，每个文件夹的文件计数（可配置深度）。
aps_docs APS快速参考：常见ID格式、浏览工作流程、API路径、文件扩展名、错误排除。

高级用户工具

工具 说明
aps_get_token 验证凭据/获取两条腿的访问令牌。所有其他工具都会自动处理令牌。
aps_dm_request 呼叫 任何 来自的数据管理API终结点 APS数据管理规范: project/v1 （中心、项目、顶级文件夹）和 data/v1 （文件夹、内容、项目、版本、下载、作业、存储、命令）。返回完整的JSON：API响应。参数： method （获取、发布、修补、删除）， path，可选 query 和 body.

典型工作流程

aps_list_hubs                                    → pick a hub
aps_list_projects(hub_id)                        → pick a project
aps_get_top_folders(hub_id, project_id)          → see root folders
aps_get_folder_contents(project_id, folder_id)   → browse files
aps_get_item_details(project_id, item_id)        → file metadata

对于写/创建操作（例如创建文件夹、创建项目、执行命令），请使用 aps_dm_request 并设置 APS_SCOPE 包括 data:write 或 data:create 根据端点的要求。

MCP捆绑包（.mcpb）

此项目可以打包为 MCP捆绑包 一键安装 克劳德桌面版 以及其他兼容MCPB的应用程序。

  1. 创建捆绑包

    npm run pack

    这将构建服务器，准备一个捆绑包目录（清单+服务器+生产依赖项），并将其压缩到 acc-mcp.mcpb，然后删除临时目录。在Windows上，脚本使用PowerShell Compress-Archive；在macOS/Linux上，它使用 zip -r.

  2. 安装捆绑包

    打开 acc-mcp.mcpb Claude for macOS或Windows（或任何支持MCPB的应用程序）。系统将提示您 APS客户端ID 和 APS客户端密码；应用程序将它们作为环境变量传递给服务器。

    有关截图的分步演练，请参阅 docs/claude-desktop安装.md.

这 manifest.json 在repo根目录下 MCPB清单规范 （manifest_version 0.3，节点服务器， user_config 用于凭证）。

许可证

麻省理工学院

相关 MCP