ACC.MCP–Autodesk平台服务的MCP服务
MCP（模型上下文协议）服务器，公开 Autodesk平台服务（APS） 作为AI助手的工具（例如Cursor）。
需求
- Node.js 18+
- APS应用程序 随着 客户端ID 和 客户端密钥 （两条腿的OAuth）
设置
- 安装依赖项
npm install- 配置凭据
复制 .env.example 到 .env 并设置您的APS应用程序凭据：
cp .env.example .env
# Edit .env: set APS_CLIENT_ID and APS_CLIENT_SECRET- 构建
npm run build- 包装（可选）
如果你想在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）
- 创建捆绑包
npm run pack这将构建服务器，准备一个捆绑包目录（清单+服务器+生产依赖项），并将其压缩到 acc-mcp.mcpb，然后删除临时目录。在Windows上，脚本使用PowerShell Compress-Archive；在macOS/Linux上，它使用 zip -r.
- 安装捆绑包
打开 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 用于凭证）。
许可证
麻省理工学院