aps-aecdm-mcp-dotnet

Platforms

.NET

License

oAuth2

Data-Management

AEC-Data-Model

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

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

aps-aecdm-mcp-dotnet