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:

1. GetToken to obtain a PKCE token that is used in the APS API requests.
2. GetHubs to retrieve the hubs using the AEC Data Model API
3. GetProjects to retrieve the projects using the AEC Data Model API
4. GetElementGroupsByProject to retrieve the ElementGroups using the AEC Data Model API
5. GetElementsByElementGroupWithCategoryFilter to retrieve the elements from one ElementGroup using a category filter.
6. RenderModel to render one design with the Viewer
7. 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 file

{
    "mcpServers": {
      "aecdm": {
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "C:\\Users\\...mcp-server-aecdm.csproj",
                "--no-build"
            ]
        }
    }
}

Further Reading

Troubleshooting

1. Can't find my hub: Provision your APS app in your hub of Forma for Construction

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