APS MCP Server

@kpphillips

About APS MCP Server

Simple prototype MCP server integrating Autodesk APIs

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"
      }
    }
  }
}

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.

FAQ from APS MCP Server

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.

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

Basic information

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K