Codeanalysismcp

🚀 CodeAnalysisMCP

CodeAnalysisMCP 是一個模型上下文協議（MCP）服務器，它藉助 Roslyn 為 .NET C# 項目和單體倉庫提供代碼分析功能。該服務能讓 AI 代理檢測未引用的代碼、分析解決方案結構，並執行其他代碼質量檢查。

✨ 主要特性

• 未引用代碼檢測：找出代碼庫中從未被引用的類、方法、屬性和字段。
• 可配置範圍：可分析整個解決方案、特定項目，或按文件路徑進行過濾。
• 入口點感知：可選擇在分析時排除入口點（如 Main 方法、測試方法、控制器）。
• 公共成員過濾：可選擇在分析中包含或排除公共成員。
• 詳細結果：獲取包含文件路徑、行號、成員類型和可訪問性級別的全面報告。

📦 安裝指南

環境要求

• .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. 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 文件的完整路徑

🔧 技術細節

工作原理

1. 工作區加載：使用 Roslyn 的 MSBuildWorkspace 加載解決方案和項目。
2. 符號分析：遍歷語法樹以查找所有聲明的符號。
3. 引用查找：使用 SymbolFinder.FindReferencesAsync 查找每個符號的所有引用。
4. 過濾：應用可配置的過濾器，用於過濾公共成員、入口點、項目和文件。
5. 結果：返回包含成員信息和統計數據的詳細 JSON。

架構

• 模型：用於分析選項和結果的數據傳輸對象。
• 服務：
  • WorkspaceLoader：通過 Roslyn 處理解決方案和項目的加載。
  • UnreferencedCodeAnalyzer：執行實際的代碼分析。
• 工具：MCP 工具定義，向 AI 代理公開分析功能。

📄 許可證

詳情請參閱 LICENSE.md。

⚠️ 侷限性

• 僅分析 C# 代碼（通過 Roslyn）。
• 要求項目可構建（MSBuild 必須能夠恢復和處理它們）。
• 對於非常大的解決方案，分析可能會很慢（考慮使用項目或文件過濾器）。
• 不檢測不可達代碼（如返回語句後的代碼等），僅檢測未引用的符號。

💡 未來增強功能

未來版本可能具備的功能：

• 死代碼檢測（不可達代碼）
• 圈複雜度分析
• 代碼重複檢測
• 依賴圖分析
• 交叉引用報告