基本能力
产品定位
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