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