RR MCP Server for .NET Analysis

.NET 分析用 RR MCP サーバー

PowerShell スクリプトを使用して、あらゆる .NET ソリューションから .NET のインターフェース、OpenAPI、データ（モデル／エンティティ／列挙型）に関する情報を抽出する、汎用 MCP サーバーです。 内容を公開せずに、AI に大規模プロジェクトの構造と抽象化情報を提供することを目的としています。

.NET ソリューションの AI 管理と自動化に向けて、今後さらに多くのツールを追加する予定です。

依存関係

• ModelContextProtocol — Model Context Protocol サーバーおよびクライアント向けの公式 C# SDK です。GitHub

機能

• あらゆる .NET ソリューションからモデル、エンティティ、列挙型、インターフェースを抽出します
• AI エージェントにプロジェクトの構造とコンテキストをすべて提供し、重複した生成を防ぎます
• Cursor、Copilot、Claude、または MCP 互換ツールですぐに使用できます
• キャッシュにより高速に動作し、クリーンな出力（stdout に余計な出力なし）と、ファイルへの完全なログ記録を実現します
• スクリプトを自動検出し、相対／絶対パスの .sln に対応します
• クロスプラットフォーム（Windows、macOS、Linux）で動作し、PowerShell 7 以降が必要です

出力形式の例

データツール（GetData）

• モデル／エンティティ：

  {
    "n": "UserModel",
    "b": "BaseModel",
    "p": { "Id": "string", "Name": "string", "Age": "int" },
    "prj": "My.Project.Namespace"
  }
  

  • *Entity サフィックスが付いたクラスは、基底クラスの要件なしでエンティティとして含まれます。
• 列挙型：

  {
    "n": "StatusType",
    "m": { "Unknown": 0, "Active": 1, "Inactive": 2 },
    "prj": "My.Project.Namespace"
  }
  

インターフェースツール（GetInterfaces）

• インターフェース：

  {
    "n": "IMyService",
    "b": "IBaseService",
    "d": "Service for handling user operations.",
    "m": [
      "Task DoWork(string arg);",
      { "s": "Task<int> GetCount();", "d": "Gets the count." }
    ],
    "prj": "My.Project"
  }
  

  • n：インターフェース名
  • b：基底インターフェース（任意）
  • d：インターフェースのドキュメント（任意）
  • m：メソッド（シグネチャ文字列、またはドキュメントを含むオブジェクト）
  • prj：プロジェクト名

命名規則

• モデル：*Model
• エンティティ：*Entity
• 列挙型：*Type
• インターフェース：I*Service、I*Repository など

スクリプトの手動実行（キャッシュのウォームアップまたはデバッグ用）

PowerShell スクリプトを直接実行して、事前にキャッシュをウォームアップしたり、出力をデバッグしたりできます。リポジトリのルート、または RR.MCP ディレクトリから実行してください。

インターフェースの場合：

pwsh -File RR.MCP/GetInterfacesPwsh.ps1 -SolutionFile MySolution.sln

データ（モデル／エンティティ／型）の場合：

pwsh -File RR.MCP/GetDataPwsh.ps1 -SolutionFile MySolution.sln

• Windows、macOS、Linux では、pwsh（PowerShell 7 以降）が PATH に設定されていることを確認してください。
• 必要に応じて、別のソリューションファイルを指定できます。
• 出力は .cache/ に、ログは mcp_debug.log／mcp_data_debug.log に書き込まれます。

要件

• .NET 9.0 SDK 以降
• PowerShell 7.0 以降（システム環境変数 PATH に pwsh が設定されている必要があります）

セットアップ

1. クローンしてビルドする

   git clone
   cd RR.MCP
   dotnet build
   

2. MCP クライアントを設定する stdio MCP サーバーのエントリを追加します。例：

   {
     "mcpServers": {
       "rr-mcp": {
         "command": "dotnet",
         "args": ["run", "--project", "<absolute-path-to>/RR.MCP/RR.MCP.csproj"]
       }
     }
   }
   

   • サーバーは、利用可能なすべてのツール（インターフェース、データなど）を自動登録します。

3. 使用方法 エージェントがツールを呼び出すためのルールを追加します。

   • GetInterfaces ツールを呼び出して、インターフェース／OpenAPI 情報を抽出します。
   • GetData ツールを呼び出して、構造を含むすべてのモデル、エンティティ、型（列挙型）を抽出します。
   • .sln ファイルのパスを solutionFile パラメーターに渡します（絶対パス、またはサーバーの作業ディレクトリからの相対パス）。

ログ記録とデバッグ

• すべての C# エラーは mcp_errors.log（出力ディレクトリ内）に記録されます。
• PowerShell スクリプトのすべての動作とエラーは、スクリプトと同じ場所にある mcp_debug.log（インターフェース）および mcp_data_debug.log（データ）に記録されます。
• PowerShell 7 未満で実行すると、PowerShell スクリプトはログを記録し、エラーを返します。

PowerShell スクリプト

• スクリプトは常に出力ディレクトリにコピーされ、pwsh -File ... で実行されます。
• 重要な手順、パラメーター、エラーをすべて記録します。
• ソリューションファイルが見つからない場合やデータが検出されない場合は、適切にエラーを処理してログに記録します。
• キャッシュはプロジェクトごとに作成され、ハッシュベースで繰り返しの実行を高速化します。（大規模プロジェクトでは初回の実行に時間がかかるため、スクリプトを手動で実行してください）

カスタマイズ

• ほかのコード分析に対応させるには、GetInterfacesPwsh.ps1 または GetDataPwsh.ps1 を編集します。
• ツールを追加するには、C# ツールファイルに新しい [McpServerTool] メソッドを追加します。

あらゆる AI IDE との統合

• この MCP サーバーは完全に汎用的であり、MCP stdio トランスポートに対応するあらゆる AI IDE またはツールと統合できます。
• ツールは自動検出され、簡単に利用できるよう OpenAPI を通じて説明されます。
• IDE 固有のロジックはなく、すべての出力がプロトコルに準拠しています。

---

Cursor との連携例

Cursor を使用している場合は、以下を .cursor/mcp.json に追加してください。

{
  "mcpServers": {
    "rr-mcp": {
      "command": "dotnet",
      "args": ["run", "--project", "<absolute-path-to>/RR.MCP/RR.MCP.csproj"]
    }
  }
}

貢献

• プルリクエストとイシューを歓迎します！
• すべての出力がプロトコルに準拠し、ログがすべてファイルにのみ出力されるようにしてください。

ライセンス

MIT