DNN API Server (.NET C# Version)

DNN API Server（.NET C# 版本）

使用 .NET 和 C# 编写的 DNN Platform Model Context Protocol（MCP）服务。

概述

此服务实现了 Model Context Protocol，可通过 DNN Platform API 提供交互工具。这是使用官方 ModelContextProtocol SDK 对 Node.js 实现的 C# 移植版本。

功能

• 使用 DNN API 进行身份验证
• 主机管理工具
• 门户管理工具
• 支持通过环境变量或 JSON 文件配置站点
• 使用 MCP SDK 特性轻松扩展

要求

• .NET 7.0 或更高版本
• DNN Platform 实例

配置

可使用环境变量配置此服务：

• DNN_API_URL：DNN 安装的 API URL（必需）
• DNN_USERNAME：DNN 用户名（未使用令牌时必需）
• DNN_PASSWORD：DNN 密码（未使用令牌时必需）
• DNN_SITES_FILE：包含站点配置的 JSON 文件路径（可选）
• DNN_SITE：要使用的站点配置名称（来自站点文件，可选，默认值："dnn18"）

站点配置文件格式

{
  "sites": {
    "dnn18": {
      "url": "https://your-dnn-site.com",
      "token": "your-jwt-token",
      "expires": "2025-12-31"
    }
  }
}

构建和运行

cd DnnApiServer
dotnet build
dotnet run

可用工具

主机工具

• get_host：获取 DNN 主机设置
• clear_cache：清除 DNN 缓存

门户工具

• get_portal：获取门户详情
• list_portals：列出所有门户

添加新工具

要添加新工具，只需向 DnnTools 类添加新方法：

1. 打开 Tools/DnnTools.cs
2. 在适当的区域中添加新方法（或创建新区域）
3. 使用 [McpServerTool] 和 [Description] 特性修饰该方法
4. 重新构建项目

例如：

[McpServerTool]
[Description("Get page details")]
public async Task<string> GetPage(int pageId, int portalId)
{
    var data = await ExecuteCommandAsync(portalId, $"get-page --id {pageId}");
    return JsonSerializer.Serialize(data, new JsonSerializerOptions { WriteIndented = true });
}

许可证

MIT