aps-aecdm-mcp-dotnet

aps-aecdm-mcp-dotnet

用于连接 Claude Desktop、AEC Data Model API 和 Viewer 的 .NET MCP 服务。

简介

此示例最初是一次关于全新 Model Context Protocol 的实验，它作为一项挑战在我们的某次 Autodesk Platform Accelerators 活动中提出。特别感谢 Mirco Bianchini 提出这项挑战，并为实现本仓库展示的解决方案作出贡献。

先决条件

要运行此项目，你需要：

• 下载并安装 Claude Desktop
• 克隆或下载此仓库
• 构建此项目
• 在 Claude 配置文件中添加对 .csproj 的引用（开发者资源）

点击此处观看演示视频

工作原理

此示例使用 ModelContextProtocol .NET SDK 创建了一个 MCP 服务。

在此项目中，我们向服务添加了 4 个主要工具：

1. GetToken，用于获取 APS API 请求中使用的 PKCE 令牌。
2. GetHubs，用于通过 AEC Data Model API 获取 hubs
3. GetProjects，用于通过 AEC Data Model API 获取项目
4. GetElementGroupsByProject，用于通过 AEC Data Model API 获取 ElementGroups
5. GetElementsByElementGroupWithCategoryFilter，用于通过类别筛选器获取某个 ElementGroup 中的元素。
6. RenderModel，用于使用 Viewer 渲染设计
7. HighLightElements，用于在 Viewer 中高亮显示元素。

使用这些工具，你可以通过自然语言，借助 AEC Data Model API 查询 elementgroups 中的数据。

这是一次对这一新协议的初步实验。欢迎提交建议并参与协作，帮助我们改进其功能。

设置

本地运行

克隆或下载此项目。建议安装 GitHub desktop。要通过命令行克隆，请使用以下命令（在 MacOSX/Linux 上使用 Terminal，在 Windows 上使用 Git Shell）：

git clone https://github.com/joaomartins-callmejohn/aps-aecdm-mcp-dotnet

Visual Studio（Windows）：

将 client_id 替换为你自己的密钥（单页应用程序）。 你可以直接在 'Properties/lauchSettings.json' 文件中修改，也可以通过 Visual Studio UI 在调试属性中修改。

你需要在 claude_desktop_congif.json 文件中添加对 MCP 服务的引用

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

延伸阅读

故障排查

1. 找不到我的中心：在 Forma for Construction 中的中心配置 APS 应用

2. 如果你修改了代码，并希望这些更改反映在 Claude 中，则需要先结束 CLaude 任务，然后再重新构建解决方案。

许可证

此示例采用 MIT License 授权。详情请参阅 LICENSE 文件。

作者

João Martins in/jpornelas