C

code-health-suite

code-health-suite

本地服务

github.com/neogeweb3开发工具023 周前更新

关于 code-health-suite

Code Health Suite 是面向开发者与团队的 Python 代码质量 MCP 服务。它仅依赖标准库，分析范围涵盖复杂度、安全、依赖、测试、类型等方面。

主要功能

01分析复杂度并计算项目健康分
02查找未使用代码和代码克隆
03扫描安全问题与依赖项
04检查导入关系和模块耦合
05审计测试、类型、环境和提交
06汇总结果生成完整健康报告

适用场景

01审查 Python 项目的整体代码健康状况
02发现安全风险与依赖问题
03修改文件前评估变更影响范围
04检查测试质量和类型标注覆盖率

MCP 相关

通过 16 个分析引擎向 MCP 客户端提供 28 种工具，涵盖单项审计和综合健康检查。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "neogeweb3-code-health-suite": {
      "command": "uvx",
      "args": [
        "code-health-suite"
      ]
    }
  }
}

启动命令uvx code-health-suite

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypicode-health-suite0.8.1stdio

工具

28

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
top	integer	否	仅返回复杂度最高的前 N 个函数。0 = 全部。
path	string	是	要分析的文件或目录路径。
sort_by	enum	否	排序指标（默认值：complexity）。complexity \| cognitive \| length \| nesting
threshold	integer	否	圈复杂度阈值（默认值：10）。

详细介绍

代码健康套件

16 个分析引擎，28 个 MCP 工具，用于 Python 代码质量检查。零外部依赖。

快速开始

作为 MCP 服务使用（Claude Desktop / Claude Code）

{
  "mcpServers": {
    "code-health": {
      "command": "code-health-suite"
    }
  }
}

从 PyPI 安装

pip install code-health-suite

或使用 uvx（无需安装）：

uvx code-health-suite

从 GitHub 安装

pip install git+https://github.com/nge/code-health-suite

工具

#	工具	引擎	功能
1	`analyze_complexity`	complexity	按函数统计圈复杂度、认知复杂度、嵌套层级和评级
2	`get_complexity_score`	complexity	项目健康评分，范围为 0-100
3	`find_dead_code`	dead-code	查找未使用的导入、函数、变量和参数
4	`security_scan`	security	OWASP 漏洞扫描，提供 CWE 映射结果
5	`get_security_score`	security	安全健康评分，范围为 0-100
6	`analyze_imports`	import-graph	导入依赖图和循环依赖分析
7	`get_import_health`	import-graph	导入架构评分，范围为 0-100
8	`find_clones`	clone-detect	检测 Type-1/2/3 代码克隆
9	`analyze_test_quality`	test-quality	测试套件指标和反模式分析
10	`full_health_check`	all engines	生成包含总体评级的综合报告
11	`find_hotspots`	hotspot	查找 git 变更频繁且复杂度高的文件
12	`get_hotspot_score`	hotspot	项目变更频率与复杂度评分
13	`audit_dependencies`	dep-audit	检查过时或存在漏洞的依赖项
14	`analyze_change_impact`	change-impact	分析文件变更的影响范围
15	`get_coupling_score`	change-impact	模块耦合指标
16	`analyze_types`	type-audit	类型注解覆盖率
17	`get_type_score`	type-audit	类型覆盖率评分，范围为 0-100
18	`audit_env`	env-audit	环境变量审计
19	`audit_git_commits`	git-audit	提交质量审计（安全性 + 复杂度）
20	`get_git_audit_score`	git-audit	Git 提交健康评分

要求

Python 3.10+
零外部依赖（仅使用标准库）

许可证

MIT

评论

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。