Autodesk Construction Cloud (ACC) MCP Server

A Model Context Protocol (MCP) server for Autodesk Construction Cloud Issues API. This server enables AI assistants like Claude to interact with ACC Issues - creating, querying, and managing construction issues.

Overview

This MCP server follows schema-driven Python development principles to provide a robust interface to the Autodesk Construction Cloud Issues API with the following capabilities:

Create new issues from natural language descriptions
Query and filter existing issues
Get detailed issue information
Search issues with natural language
Add comments to issues

Key Features

3-Legged OAuth Authentication: Securely handles the authentication flow with ACC
Smart Field Mapping: Maps natural language to appropriate issue fields
Metadata Caching: Efficiently caches project metadata to minimize API calls
Comprehensive Validation: Validates all fields according to ACC requirements
Error Handling: Provides clear and actionable error messages

Prerequisites

Python 3.10+
Autodesk Construction Cloud account
Autodesk Forge application with 3-legged OAuth configured

Setup

Environment Configuration

# OAuth Configuration
ACC_CLIENT_ID=your_client_id
ACC_CLIENT_SECRET=your_client_secret
ACC_REDIRECT_URI=http://127.0.0.1:8000/oauth/callback

# Project Configuration
ACC_PROJECT_ID=your_project_id

# Server Configuration
ACC_API_URL=https://developer.api.autodesk.com/construction/issues/v1
ACC_CALLBACK_PORT=8000

Installation

# Clone the repository
git clone https://github.com/itaico82/ACC_MCP_V0.2.git
cd ACC_MCP_V0.2

# Create and activate a virtual environment
python -m uv venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip sync requirements.txt

Usage

# Start the MCP server
python -m src.main

Development

This project follows schema-driven development principles with a clear separation of concerns:

src/schemas/: Data models generated from OpenAPI schema
src/auth/: OAuth authentication handling
src/api/: ACC API client implementation
src/tools/: MCP tool implementations
src/utils/: Utility functions and helpers

License

MIT

V0.2