aps-aecdm-mcp-dotnet
.NET MCP Server to connect with Claude Desktop, AEC Data Model API and the Viewer.
Introduction
This sample started as an experiment with the new Model Context Protocol brought as a challenge during one of our Autodesk Platform Accelerators. Special thanks to Mirco Bianchini for bringing this challenge and contributing to get to the solutions presented in this repo.
Prerequisites
To make this work, you'll need to:
- Download and Install Claude Desktop
- Clone or download this repo
- Build this project
- Add a reference to the .csproj in the Claude configuration file (developers resource)
DEMO VIDEO HERE
How it works
This sample creates an MCP server using the ModelContextProtocol .NET SDK.
In this scope we added 4 main tools to our server:
- GetToken to obtain a PKCE token that is used in the APS API requests.
- GetHubs to retrieve the hubs using the AEC Data Model API
- GetProjects to retrieve the projects using the AEC Data Model API
- GetElementGroupsByProject to retrieve the ElementGroups using the AEC Data Model API
- GetElementsByElementGroupWithCategoryFilter to retrieve the elements from one ElementGroup using a category filter.
- RenderModel to render one design with the Viewer
- HighLightElements to highlight elements in the Viewer.
With these tools, you can use natural language to query the data from your elementgroups using the AEC Data Model API.
This is a first experiment with this new protocol. Feel free to submit suggestions and collaborate to this repo so we can improve its functionalities.
Setup
Running locally
Clone this project or download it. It's recommended to install GitHub desktop. To clone it via command line, use the following (Terminal on MacOSX/Linux, Git Shell on Windows):
git clone https://github.com/joaomartins-callmejohn/aps-aecdm-mcp-dotnet
Visual Studio (Windows):
Replace client_id with your own key (Single Page application).
You can do it directly in the 'Properties/lauchSettings.json' file or through Visual Studio UI under the debug properties.
You'll need to add a reference to your MCP server in the claude_desktop_congif.json filejson
{
"mcpServers": {
"aecdm": {
"command": "dotnet",
"args": [
"run",
"--project",
"C:\\Users\\...mcp-server-aecdm.csproj",
"--no-build"
]
}
}
}
Further Reading
Troubleshooting
-
Can't find my hub: Provision your APS app in your ACC hub
-
If you made changes to the code and want this to be reflected in Claude, you'll need to end the CLaude task before rebuilding the solution.
License
This sample is licensed under the terms of the MIT License. Please see the LICENSE file for full details.
Written by
João Martins in/jpornelas
