ACC.MCP – MCP service for Autodesk Platform Services

MCP (Model Context Protocol) server that exposes Autodesk Platform Services (APS) as tools for AI assistants (e.g. Cursor).

Requirements

• Node.js 18+
• APS application with Client ID and Client Secret (2-legged OAuth)

Setup

1. Install dependencies

   npm install

2. Configure credentials

   Copy .env.example to .env and set your APS app credentials:

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

3. Build

   npm run build

4. Pack (optional) If you want to use it on Claude Desktop, you can pack the MCP to a .mcpb

   npm run pack

Running the MCP service

The server uses stdio transport: a client (e.g. Cursor) spawns this process and talks to it via stdin/stdout.

• Run directly: npm start or node dist/index.js
• With env file: use dotenv or your shell to load .env before starting

Cursor configuration

Add this MCP server in Cursor (e.g. Settings → MCP or .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"
      }
    }
  }
}

Use the path to dist/index.js that matches your machine. You can also run via npx or a wrapper script that loads .env and then runs node dist/index.js.

Tools

Simplified tools (recommended)

These return compact, pre-processed summaries (~95 % smaller than raw API responses) and include parameter validation with helpful error messages.

Tool	Description
aps_list_hubs	List all ACC / BIM 360 hubs (accounts) — returns name, id, type, region.
aps_list_projects	List projects in a hub — returns name, id, platform, last modified.
aps_get_top_folders	Get root folders for a project (Project Files, Plans, Shared, …).
aps_get_folder_contents	Summarised folder listing with file-type breakdown, sizes, version info. Supports filtering by extension and hiding hidden items.
aps_get_item_details	Metadata for a single file: name, type, size, version number, dates.
aps_get_folder_tree	Recursive folder-tree with file counts per folder (configurable depth).
aps_docs	APS quick-reference: common ID formats, browsing workflow, API paths, file extensions, error troubleshooting.

Power-user tools

Tool	Description
aps_get_token	Verify credentials / obtain a 2-legged access token. All other tools handle tokens automatically.
aps_dm_request	Call any Data Management API endpoint from the APS Data Management spec: project/v1 (hubs, projects, topFolders) and data/v1 (folders, contents, items, versions, downloads, jobs, storage, commands). Returns the full JSON:API response. Parameters: method (GET, POST, PATCH, DELETE), path, optional query and body.

Typical workflow

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

For write/create operations (e.g. create folder, create item, execute command) use aps_dm_request and set APS_SCOPE to include data:write or data:create as required by the endpoint.

MCP Bundle (.mcpb)

This project can be packed as an MCP Bundle for one-click install in Claude Desktop and other MCPB-compatible apps.

1. Create the bundle

   npm run pack

   This builds the server, prepares a bundle directory (manifest + server + production dependencies), zips it to acc-mcp.mcpb, then removes the temp directory. On Windows the script uses PowerShell Compress-Archive; on macOS/Linux it uses zip -r.

2. Install the bundle

   Open acc-mcp.mcpb in Claude for macOS or Windows (or any app that supports MCPB). You’ll be prompted for APS Client ID and APS Client Secret; the app will pass them to the server as environment variables.

The manifest.json at the repo root follows the MCPB manifest spec (manifest_version 0.3, Node server, user_config for credentials).

License

MIT