Codeanalysismcp

🚀 CodeAnalysisMCP

Roslynを使用して、.NET C#プロジェクトとモノレポにコード分析機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。このサービスにより、AIエージェントは未参照コードの検出、ソリューション構造の分析、その他のコード品質チェックを行うことができます。

✨ 主な機能

• 未参照コードの検出：コードベース内で一度も参照されていないクラス、メソッド、プロパティ、フィールドを見つけます。
• 設定可能なスコープ：ソリューション全体、特定のプロジェクト、またはファイルパスでフィルタリングして分析できます。
• エントリーポイントの認識：オプションで、分析からエントリーポイント（Mainメソッド、テストメソッド、コントローラー）を除外できます。
• パブリックメンバーのフィルタリング：分析にパブリックメンバーを含めるか除外するかを選択できます。
• 詳細な結果：ファイルパス、行番号、メンバーの種類、アクセスレベルを含む包括的なレポートを取得します。

📚 詳細ドキュメント

1. AnalyzeSolution

.NETソリューションファイル（.sln）の未参照コードメンバーを分析します。

パラメーター:

• solutionPath (文字列, 必須): .slnファイルの完全なパス
• includePublicMembers (ブール値, オプション, デフォルト: true): 結果にパブリックメンバーを含める
• includeEntryPoints (ブール値, オプション, デフォルト: false): 結果にエントリーポイントを含める
• projectFilter (文字列, オプション): プロジェクト名のフィルターをカンマ区切りで指定
• fileFilter (文字列, オプション): ファイルパスのフィルターをカンマ区切りで指定

2. AnalyzeProject

単一の.NETプロジェクトファイル（.csproj）の未参照コードメンバーを分析します。

パラメーター:

• projectPath (文字列, 必須): .csprojファイルの完全なパス
• includePublicMembers (ブール値, オプション, デフォルト: true): 結果にパブリックメンバーを含める
• includeEntryPoints (ブール値, オプション, デフォルト: false): 結果にエントリーポイントを含める
• fileFilter (文字列, オプション): ファイルパスのフィルターをカンマ区切りで指定

3. GetSolutionInfo

.NETソリューション内のプロジェクトに関する概要情報を取得します。

パラメーター:

• solutionPath (文字列, 必須): .slnファイルの完全なパス

📦 インストール

必要条件

• .NET 9.0以降
• MSBuild（Visual Studioまたは.NET SDKに含まれています）

ビルド

dotnet build

MCPサーバーとして実行

サーバーは標準入出力を介して通信し、MCP互換のAIクライアントと一緒に使用するように設計されています。

dotnet run

Claude Desktopの設定

Claude Desktopの設定ファイルに追加してください。 Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "code-analysis": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "C:\\path\\to\\CodeAnalysisMCP\\CodeAnalysisMCP.csproj"
      ]
    }
  }
}

💻 使用例

設定が完了したら、Claudeにコードを分析させることができます。

• "C:\MyProject\MyProject.slnのソリューションを分析し、すべての未参照コードを見つけてください"
• "C:\MyProject\MyLib\MyLib.csprojのプロジェクトをチェックし、未使用のプライベートメソッドを見つけてください"
• "MyProject.slnの未参照コードを見つけるが、テストプロジェクトは除外してください"
• "C:\MyProject\MyProject.slnのソリューションに含まれるプロジェクトは何ですか？"

🔧 技術詳細

1. ワークスペースの読み込み：RoslynのMSBuildWorkspaceを使用してソリューションとプロジェクトを読み込みます。
2. シンボル分析：構文木をトラバースしてすべての宣言されたシンボルを見つけます。
3. 参照の検索：SymbolFinder.FindReferencesAsyncを使用して、各シンボルへのすべての参照を見つけます。
4. フィルタリング：パブリックメンバー、エントリーポイント、プロジェクト、ファイルに対して設定可能なフィルターを適用します。
5. 結果：メンバー情報と統計を含む詳細なJSONを返します。

🏗️ アーキテクチャ

• モデル：分析オプションと結果のデータ転送オブジェクト
• サービス：
  • WorkspaceLoader：Roslynを介してソリューションとプロジェクトの読み込みを処理します。
  • UnreferencedCodeAnalyzer：実際のコード分析を実行します。
• ツール：AIエージェントに分析機能を公開するMCPツールの定義

🚫 制限事項

• C#コードのみを分析します（Roslynを介して）。
• プロジェクトがビルド可能である必要があります（MSBuildが復元および処理できる必要があります）。
• 非常に大きなソリューションの分析は低速になる場合があります（プロジェクトまたはファイルのフィルターを使用することを検討してください）。
• 到達不能コード（return文以降のコードなど）は検出されません - 未参照シンボルのみを検出します。

🌟 将来の機能拡張

将来のリリースで予定されている潜在的な機能：

• デッドコード検出（到達不能コード）
• 循環的複雑度分析
• コード重複検出
• 依存関係グラフ分析
• 相互参照レポート

📄 ライセンス

詳細については、LICENSE.mdを参照してください。