code-health-suite について
Code Health Suiteは、開発者やチーム向けのPythonコード品質MCPサーバーです。標準ライブラリのみで、複雑度、セキュリティ、依存関係、テスト、型などを分析します。
主な機能
- 01複雑度を分析しプロジェクトのスコアを算出
- 02未使用コードとコードクローンを検出
- 03セキュリティ問題と依存関係をスキャン
- 04インポート関係とモジュール結合度を調査
- 05テスト、型、環境、コミットを監査
- 06結果を統合した総合ヘルスレポートを作成
活用シーン
- 01Pythonプロジェクト全体のコード品質を確認
- 02セキュリティリスクと依存関係の問題を検出
- 03ファイル変更前に影響範囲を評価
- 04テスト品質と型アノテーションのカバー率を確認
MCP 対応
16の分析エンジンを通じて、個別監査や総合ヘルスチェックなど28種類のツールをMCPクライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
28掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| top | integer | いいえ | 複雑度上位 N 件の関数のみを返します。0 = すべて。 |
| path | string | はい | 分析するファイルまたはディレクトリのパス。 |
| sort_by | enum | いいえ | 並べ替えの指標(デフォルト:complexity)。complexity | cognitive | length | nesting |
| threshold | integer | いいえ | 循環的複雑度のしきい値(デフォルト:10)。 |
詳細
Code Health Suite
Python コード品質のための 16 の分析エンジンと 28 の MCP ツール。外部依存関係はありません。
クイックスタート
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 | 関数ごとの CC、認知的複雑度、ネスト、評価 |
| 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 | タイプ 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 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。