MCP.so
ログイン

APS MCP Server

@kpphillips

基本情報

カテゴリ

その他

ライセンス

GPL-3.0 license

トランスポート

stdio

作者

kpphillips

APS MCP Server について

Simple prototype MCP server integrating Autodesk APIs

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 のツール

4

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.

よくある質問

1

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.

2

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.

3

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.

4

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.

5

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

コメント

「その他」の他のコンテンツ