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 必须能够恢复和处理它们）。
• 对于非常大的解决方案，分析可能会很慢（考虑使用项目或文件过滤器）。
• 不检测不可达代码（如返回语句后的代码等），仅检测未引用的符号。

💡 未来增强功能

未来版本可能具备的功能：

• 死代码检测（不可达代码）
• 圈复杂度分析
• 代码重复检测
• 依赖图分析
• 交叉引用报告