APS MCP Server

@kpphillips

代码仓库

基本信息

分类

其他

许可证

GPL-3.0 license

传输方式

stdio

作者

kpphillips

关于 APS MCP Server

Simple prototype MCP server integrating Autodesk APIs

#autodesk #mcp #server

APS MCP Server 配置

使用下面的配置,将此服务器添加到你的 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"
      }
    }
  }
}

APS MCP Server 工具

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.

常见问题

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`.

其他分类下的更多 MCP 服务器

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

🚀 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