概要
What is aps-aecdm-mcp-dotnet?
aps-aecdm-mcp-dotnet is a .NET MCP server that connects Claude Desktop with the Autodesk AEC Data Model API and Viewer. It allows users to query AEC data (hubs, projects, element groups, elements) using natural language and visualize results in a 3D viewer.
How to use aps-aecdm-mcp-dotnet?
Clone or download the repo, build the project with .NET 8, and add a reference to the .csproj in the Claude Desktop configuration file (claude_desktop_config.json). Replace the client_id with your own APS Single Page Application key. Invoke tools such as GetToken, GetHubs, GetProjects, GetElementGroupsByProject, GetElementsByElementGroupWithCategoryFilter, RenderModel, and HighLightElements.
Key features of aps-aecdm-mcp-dotnet
- Obtain a PKCE token for APS API requests.
- Retrieve hubs using the AEC Data Model API.
- Retrieve projects using the AEC Data Model API.
- Retrieve element groups by project.
- Retrieve elements filtered by category from an element group.
- Render a design with the Autodesk Viewer.
- Highlight elements in the Viewer.
Use cases of aps-aecdm-mcp-dotnet
- Query AEC data from element groups using natural language in Claude Desktop.
- Retrieve and inspect hubs, projects, and element groups via the APS APIs.
- Filter and highlight specific elements in the 3D Viewer for review.
FAQ from aps-aecdm-mcp-dotnet
What prerequisites are needed?
You need Claude Desktop, .NET 8, a cloned or downloaded repo, and a provisioned APS app in your hub.
How do I set up authentication?
The server uses the GetToken tool to obtain a PKCE token; you must provide your own APS Single Page Application client_id in the debug settings.
I can’t find my hub. What should I do?
Provision your APS app in your hub or in Forma for Construction as described in the Autodesk documentation.
How do I reflect code changes in Claude?
End the current Claude task before rebuilding the solution, then restart the task.
What APIs does this server use?
It uses the AEC Data Model API (v1), Data Management API (v2), and oAuth2 (v1) from Autodesk Platform Services.
