APS MCP Server

@kpphillips

Repository

Basic information

About APS MCP Server

Simple prototype MCP server integrating Autodesk APIs

#autodesk #mcp #server

APS MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "acc": {
      "command": "/ABSOLUTE/PATH/TO/YOUR/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/YOUR/aps_dm_server.py"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER"
      }
    }
  }
}

APS MCP Server tools

Get all available hubs

Get all projects within a hub

Get files in a specific folder of a project

Get version information for a specific item

Overview

What is APS MCP Server?

A minimal MCP server that integrates Autodesk ACC (Autodesk Construction Cloud) APIs via the APS (Autodesk Platform Services) toolkit, acting as a bridge between Claude AI and the Autodesk APS platform. It is intended for users who need to query and manage Autodesk project data through AI assistants.

How to use APS MCP Server?

Clone the repository, copy .env.sample to .env and fill in your Autodesk credentials. Install dependencies using uv or pip, then run python aps_dm_server.py. For use with Claude Desktop, add the server configuration (with absolute paths) to claude_desktop_config.json. Optionally, use with the OpenAI Agents SDK by installing openai and running python main_agent.py.

Key features of APS MCP Server

Exposes tools to list hubs, projects, files, and versions.
Integrates with Claude Desktop via MCP protocol.
Supports OpenAI Agents SDK for AI querying.
Uses APS‑Toolkit (GPL‑3.0) for Autodesk API access.
Environment‑based credential management with .env.
Cross‑platform setup (macOS, Windows, Unix).

Use cases of APS MCP Server

Ask Claude AI to list all Autodesk hubs and projects.
Retrieve files within specific project folders.
Get version history for a particular item.
Integrate Autodesk data into conversational workflows.

Frequently asked questions

What dependencies or runtime does APS MCP Server require?

Python 3.11 or higher, with dependencies listed in `requirements.txt`. Key libraries include aps‑toolkit, mcp, python‑dotenv, and optionally openai.

Where does APS MCP Server store data or credentials?

Credentials are stored in a local `.env` file. All data remains within Autodesk APS/ACC; the server only fetches and relays information without persistent local storage.

What transport or authentication does APS MCP Server use?

It uses the MCP (Model Context Protocol) transport with JSON‑RPC messaging. Authentication is via Autodesk APS credentials configured in the `.env` file.

What are the known limits of APS MCP Server?

The README states this is a prototype “as is” with no warranty, for demonstration purposes only. No explicit performance or concurrency limits are documented.

How do I troubleshoot integration with Claude Desktop?

Check configuration JSON syntax, use absolute paths, grant Full Disk Access on macOS (System Preferences → Privacy & Security), and review logs at `~/Library/Logs/Claude/mcp*.log`. Test the server manually by running `python aps_dm_server.py`.

Comments

More Other MCP servers

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40