Autodesk Construction Cloud (ACC) MCP Server

基本能力

产品定位

ACC_MCP_V0.2 是一个用于 Autodesk Construction Cloud (ACC) 的 MCP 服务器，旨在通过 AI 助手与 ACC Issues API 进行交互，实现建筑问题的创建、查询和管理。

核心功能

• 创建问题：从自然语言描述中创建新的建筑问题
• 查询和过滤问题：查询和过滤现有的建筑问题
• 获取详细信息：获取问题的详细信息
• 自然语言搜索：使用自然语言搜索问题
• 添加评论：向问题添加评论

适用场景

• 建筑项目管理中的问题跟踪和管理
• 通过 AI 助手自动化处理建筑问题
• 团队协作中的问题沟通和解决

工具列表

• 3-Legged OAuth Authentication：处理与 ACC 的安全认证流程
• Smart Field Mapping：将自然语言映射到适当的问题字段
• Metadata Caching：高效缓存项目元数据以减少 API 调用
• Comprehensive Validation：根据 ACC 要求验证所有字段
• Error Handling：提供清晰且可操作的错误消息

常见问题解答

• 依赖问题：确保 Python 3.10+ 和 Autodesk Construction Cloud 账户
• 认证问题：确保 Autodesk Forge 应用程序配置了 3-legged OAuth

使用教程

使用依赖

• Python 3.10+
• Autodesk Construction Cloud 账户
• Autodesk Forge 应用程序配置了 3-legged OAuth

安装教程

# 克隆仓库
git clone https://github.com/itaico82/ACC_MCP_V0.2.git
cd ACC_MCP_V0.2

# 创建并激活虚拟环境
python -m uv venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖
uv pip sync requirements.txt

调试方式

# 启动 MCP 服务器
python -m src.main

许可证

该项目遵循 MIT 开源许可条款。