petrbroz_aps_mcp_server

petrbroz_aps_mcp_server

by petrbroz
An experimental MCP server providing access to Autodesk Platform Services API with fine-grained access control.

Autodesk Platform Services MCP Server

Overview

The Autodesk Platform Services MCP Server is an experimental implementation of the Model Context Protocol (MCP) built with Node.js. It provides access to the Autodesk Platform Services (APS) API, leveraging the new Secure Service Accounts feature for fine-grained access control. This server is designed to integrate with tools like Claude Desktop and the Model Context Protocol Inspector to enhance workflows for managing ACC and BIM360 projects.

Screenshot

Tools

Prerequisites

Before getting started, ensure you have the following:

Setup

  1. Clone the repository.
  2. Install dependencies: yarn install
  3. Build the TypeScript code: yarn run build
  4. Create a .env file in the root folder and add your APS credentials:
  5. APS_CLIENT_ID: Your APS application client ID.
  6. APS_CLIENT_SECRET: Your APS application client secret.
  7. Create a new service account (e.g., test-account-1): npx create-service-account test-account-1
  8. This script will output the service account email and environment variables.
  9. Add the following variables to your .env file:
  10. APS_SA_ID: Your service account ID.
  11. APS_SA_EMAIL: Your service account email.
  12. APS_SA_KEY_ID: Your service account key ID.
  13. APS_SA_PRIVATE_KEY: Your service account private key.
  14. Invite the service account email as a new member to your ACC project(s).

Configuration

Use with Inspector

  1. Run the Model Context Protocol Inspector: yarn run inspect
  2. Open http://localhost:5173
  3. Hit Connect to start the MCP server and connect to it.

Use with Claude Desktop

  1. Ensure you have Claude Desktop installed.
  2. Create a Claude Desktop config file if it doesn't exist:
  3. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  4. Windows: %APPDATA%\Claude\claude_desktop_config.json
  5. Add the MCP server to the config using the absolute path of the build/server.js file:
{
    "mcpServers": {
        "autodesk-platform-services": {
            "command": "node",
            "args": ["/absolute/path/to/aps-mcp-server/build/server.js"]
        }
    }
}
  1. Open Claude Desktop and use test prompts like:
  2. "What ACC projects do I have access to?"
  3. "Give me a visual dashboard of all issues in project XYZ."

For more details, refer to the official documentation.

Development

Languages

  • TypeScript: 93.1%
  • JavaScript: 6.9%

Resources

Stars

6 stars

Watchers

1 watching

Forks

0 forks


No releases or packages have been published yet.

Features & Capabilities

Categories
mcp_server model_context_protocol typescript nodejs autodesk_platform_services api_integration secure_service_accounts claude

Implementation Details

Stats

0 Views
6 GitHub Stars

Repository Info

petrbroz Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
21423
9300