关键词

代码质量分析技术债务识别测试覆盖率软件工程工具Git代码分析

项目简介

'claude-code-plugins' 仓库是一个包含多种 Claude Code 插件的市场，其中包含了多个基于 Model Context Protocol (MCP) 构建的服务器实现。这些 MCP 服务器是独立的 Node.js 应用程序，它们通过标准化的 JSON-RPC 协议与 LLM 客户端（如 Claude Code）通信，提供强大的后端功能。

“代码健康审计”是此仓库中一个重要的 MCP 服务器插件，它专注于对代码仓库进行全面的质量分析，帮助开发者识别潜在的技术债务、优化代码结构并提升可维护性。

主要功能点

  • 代码复杂度分析：评估文件的圈复杂度（Cyclomatic Complexity）和平均函数复杂度，帮助您了解代码的可读性和潜在的维护挑战。
  • Git 变更热点识别：分析 Git 提交历史，找出近期修改最频繁的文件。这些文件通常是“热点”，可能指示着不稳定的模块或需要重构的区域。
  • 测试覆盖率映射：自动识别源代码文件与对应的测试文件，并标记出缺少测试的关键文件，帮助您提高测试覆盖率和代码健壮性。
  • 综合健康评分：结合代码复杂度、文件变更频率和测试覆盖率等多维度指标，为每个文件生成一个直观的健康评分，并提供针对性的改进建议。

安装步骤

在您的 Claude Code 环境中安装此 MCP 服务器插件非常简单：

  1. 添加插件市场：在 Claude Code 命令行界面中执行以下命令来添加 'claude-code-plugins' 市场： 
    /plugin marketplace add jeremylongshore/claude-code-plugins
  2. 安装代码健康审计插件：市场添加成功后，安装 'project-health-auditor' 插件： 
    /plugin install project-health-auditor@claude-code-plugins

服务器配置

MCP 客户端（例如 Claude Code）需要知道如何启动并连接到 'project-health-auditor' MCP 服务器。您需要在 MCP 客户端的配置文件中指定该服务器的启动信息，通常包括：

  • 服务器名称 (server name)：'project-health-auditor'
  • 启动命令 (command)：'node'（因为这是一个 Node.js 应用程序）
  • 命令参数 (args)：一个字符串数组，包含 MCP 服务器主入口脚本的路径。例如，如果 'project-health-auditor' 服务器的编译后 JavaScript 文件位于 './plugins/mcp/project-health-auditor/servers/code-metrics.js'，则参数应为 '["./plugins/mcp/project-health-auditor/servers/code-metrics.js"]'。

MCP 客户端会利用这些配置信息启动 'node' 进程，并与 MCP 服务器通过标准输入/输出 (Stdio) 管道进行 JSON-RPC 通信。

基本使用方法

安装并配置完成后，您可以通过 Claude Code 提供的命令来触发代码健康审计功能。例如，使用 '/analyze' 命令对指定代码仓库路径进行分析：

/analyze /path/to/your/repository

LLM 客户端将自动调用 'project-health-auditor' MCP 服务器暴露的工具（如 'list_repo_files'、'file_metrics'、'git_churn'、'map_tests'），执行代码分析流程，并将结构化的分析结果和专业建议返回给您，帮助您更好地理解和改进代码质量。

信息

分类

开发者工具

访问项目