aps-mcp-server
Experimental Model Context Protocol server build with Node.js, providing access to Autodesk Platform Services API, with fine-grained access control using the new Secure Service Accounts feature.
Development
Prerequisites
- Node.js
- APS app credentials (must be a Server-to-Server application type)
- Provisioned access to ACC or BIM360
Setup
Server
- Clone this repository
- Install dependencies:
yarn install
- Build the TypeScript code:
yarn run build
- Create a .env file in the root folder of this project, and add your APS credentials:
APS_CLIENT_ID
- your APS application client IDAPS_CLIENT_SECRET
- your APS application client secret
- Create a new service account:
npx create-service-account <username> <first name> <last name>
, for example,npx create-service-account ssa-test-user John Doe
- This script will output a bunch of environment variables with information about the new account:
APS_SA_ID
- your service account IDAPS_SA_EMAIL
- your service account emailAPS_SA_KEY_ID
- your service account key IDAPS_SA_PRIVATE_KEY
- your service account private key
- This script will output a bunch of environment variables with information about the new account:
- Add these environment variables to your .env file
Autodesk Construction Cloud
- Register your APS application client ID as a custom integration
- Invite the service account email as a new member to your ACC project(s)
Use with Inspector
- Run the Model Context Protocol Inspector:
yarn run inspect
- Open http://localhost:5173
- Hit
Connect
to start this MCP server and connect to it
Use with Claude Desktop
- Make sure you have Claude Desktop installed
- Create a Claude Desktop config file if you don't have one yet:
- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%\Claude\claude_desktop_config.json
- Add this MCP server to the config, using the absolute path of the build/server.js file on your system, for example:
- Open Claude Desktop, and try some of the following test prompt:
- What ACC projects do I have access to?
- Give me a visual dashboard of all issues in project XYZ
For more details on how to add MCP servers to Claude Desktop, see the official documentation.
Use with Visual Studio Code & Copilot
- Make sure you have enabled MCP servers in Visual Studio Code
- Create .vscode/mcp.json file in your workspace, and add the following JSON to it:
For more details on how to add MCP servers to Visual Studio Code, see the documentation
Use with Cursor
- Create .cursor/mcp.json file in your workspace, and add the following JSON to it:
For more details on how to add MCP servers to Cursor, see the documentation
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Servidor Node.js experimental que implementa el Protocolo de contexto de modelo para acceder a la API de Autodesk Platform Services con control de acceso detallado mediante cuentas de servicio seguras.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.Last updated -74MIT License
- -securityFlicense-qualityA Model Context Protocol server that enables AI models to access tools through GitHub authentication and provides comprehensive analytics tracking of tool usage, performance, and user behavior.Last updated -2
- -securityAlicense-qualityA Model Context Protocol server implementation for Autodesk Construction Cloud Build that enables AI assistants to manage construction issues, RFIs, submittals, photos, forms, and costs through natural language.Last updated -MIT License