aps-aecdm-mcp-dotnet

.NET MCP 服务器，用于连接 Claude Desktop、AEC 数据模型 API 和 Viewer。

简介

此示例最初是使用新的 模型上下文协议 进行的实验，该协议是在我们的 Autodesk Platform Accelerators 之一中提出的挑战。 特别感谢 Mirco Bianchini 提出此挑战并为获得此存储库中提供的解决方案做出了贡献。

前提条件

要使其工作，您需要：

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

演示视频

工作原理

此示例使用 ModelContextProtocol .NET SDK 创建 MCP 服务器。

在此范围内，我们向服务器添加了 4 个主要工具：

1. GetToken 获取用于 APS API 请求的 PKCE 令牌。
2. GetHubs 使用 AEC 数据模型 API 检索 Hubs
3. GetProjects 使用 AEC 数据模型 API 检索 Projects
4. GetElementGroupsByProject 使用 AEC 数据模型 API 检索 ElementGroups
5. GetElementsByElementGroupWithCategoryFilter 使用类别过滤器从一个 ElementGroup 检索元素。
6. RenderModel 使用 Viewer 渲染一个设计
7. HighLightElements 在 Viewer 中高亮显示元素。

使用这些工具，您可以使用自然语言查询来自 elementgroups 的数据，使用 AEC 数据模型 API。

这是对这个新协议的第一次实验。 欢迎提交建议并协作此存储库，以便我们改进其功能。

设置

在本地运行

克隆或下载此项目。 建议安装 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. 找不到我的 Hub：在您的 ACC Hub 中配置您的 APS 应用程序

2. 如果您对代码进行了更改，并希望在 Claude 中反映出来，则需要在重建解决方案之前结束 CLaude 任务。

许可证

此示例根据 MIT 许可证 的条款获得许可。 有关完整详细信息，请参阅 LICENSE 文件。

作者

João Martins in/jpornelas