APS MCP Server

Name: APS MCP Server
Author: kpphillips

@kpphillips

代码仓库

关于 APS MCP Server

Simple prototype MCP server integrating Autodesk APIs

#autodesk #mcp #server

基本信息

分类

其他

许可证

GPL-3.0 license

运行时

python

传输方式

stdio

发布者

kpphillips

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

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

概览

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.