Apache Health MCP

このリポジトリには、tools/health/reportsからApache Incubatorの健全性レポートをクエリするための小さなMCPサーバーが含まれています。

これはApacheの健全性ツールで使用されているMarkdownレポート形式を解析し、以下のためのMCPツールを公開します：

• 利用可能なポッドリングレポートの一覧表示

• ポッドリング名の検索

• 1つのポッドリングの解析済みサマリーの取得

• 生のMarkdownレポートの取得

• 特定の期間のメトリクスの取得

• 2つまたは3つの期間にわたる1つのポッドリングの比較

• サポートされているメトリクスと期間の一覧表示

• 3m、6m、12mなどの期間内でのメトリクスによるポッドリングのランキング

期待される入力

サーバーを以下のようなMarkdownファイルを含むローカルディレクトリに向けてください：

reports/
 Amoro.md
 Iggy.md
 ...

このパーサーは、現在のApacheレポート構造、特に ## Window Details セクションを中心に設計されています。

Related MCP server: IPMC MCP

インストール

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install .

ローカル開発用：

make install-dev

実行

health-mcp --reports-dir /path/to/incubator/tools/health/reports

サーバーは stdio を使用するため、MCPクライアントによって起動されることを想定しています。

インストールせずにローカルで開発する場合でも、stdioサーバーを直接起動できます：

python3 server.py

このパッケージは、後方互換性のあるコマンドエイリアスとして apache-health-mcp も保持しています。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を編集し、以下を追加します：

{
 "mcpServers": {
 "apache-health": {
 "command": "health-mcp",
 "args": [
 "--reports-dir",
 "/path/to/incubator/tools/health/reports"
 ]
 }
 }
}

その後、Claude Desktopを再起動してください。PATH に含まれていない仮想環境にインストールした場合は、その環境の health-mcp コマンドへの絶対パスを使用してください。

MCPツール

health_overview レポートディレクトリ、レポート数、ポッドリングリスト、および最新の生成日を返します。

list_podlings レポートディレクトリで利用可能なポッドリング名を返します。

search_podlings 大文字と小文字を区別しない部分文字列でポッドリング名を検索し、オプションで結果数を制限します。

get_report_summary 単一のポッドリングの解析済み期間メトリクスを返します。

get_report_markdown 単一のポッドリングレポートの生のMarkdownを返します。

get_window_metrics 3m、6m、12m、または to-date などの1つのポッドリングと1つの期間のメトリクスを返します。これには trends 下の up、down、flat などの正規化されたトレンドワードが含まれます。

compare_windows 2つまたは3つの期間にわたる1つのポッドリングのメトリクスを並べて返します。これには各期間の trends 下の正規化されたトレンドワードが含まれます。

query_metric_rankings commits、prs_merged、dev_messages、bus50、または median_merge_days などの解析済みメトリクスによってポッドリングをランク付けします。

list_metrics クエリ用にサポートされているメトリクス名と利用可能な期間を返します。

使用例

これらの例は、このサーバーに接続されたMCPクライアントに対してユーザーが尋ねることができる質問の種類を示しています。

レポートスナップショットの確認

• 「このチェックアウトで利用可能なApache Incubatorの健全性レポートは何ですか？」

• 「ポッドリングの健全性レポートは何件あり、いつ生成されましたか？」

• 「クエリ可能な健全性レポートを持つポッドリングはどれですか？」

• 「どのような健全性メトリクスとレポート期間について尋ねることができますか？」

1つのポッドリングの調査

• 「Amoroの健全性サマリーを表示して。」

• 「最新の健全性レポートではIggyについて何と言っていますか？」

• 「名前に 'stream' を含むポッドリングを見つけて、最適な一致を要約して。」

• 「このポッドリングについて、最近の3ヶ月間の健全性メトリクスを表示して。」

• 「ソースを確認できるように、Amoroの元のMarkdownレポートを表示して。」

期間をまたいだトレンドの比較

• 「Amoroの3ヶ月、6ヶ月、12ヶ月のアクティビティを比較して。」

• 「Iggyの開発アクティビティは改善していますか、それとも減速していますか？」

• 「このポッドリングの最近のメーリングリストのアクティビティと長期的なトレンドを比較して。」

• 「このポッドリングのPRマージアクティビティは、3ヶ月と12ヶ月の期間で変化しましたか？」

• 「このポッドリングのバス係数は、レポート期間全体で良くなっていますか、悪くなっていますか？」

アクティビティシグナルによるポッドリングの検索

• 「過去3ヶ月間で開発者リストのメッセージが最も多かったポッドリングはどれですか？」

• 「過去3ヶ月間にコミットがないポッドリングを表示して。」

• 「PRマージの中央値が最も長いポッドリングはどれですか？」

• 「6ヶ月の期間でマージされたPRによってポッドリングをランク付けして。」

• 「最近のレポート期間でレビュアーの多様性が低いポッドリングを見つけて。」

人手によるレビューキューの準備

• 「最近のアクティビティに基づいて、メンターの注意が必要かもしれないポッドリングの短いリストを教えて。」

• 「コミット、PR、開発者リストのメッセージ全体で静かなポッドリングはどれですか？」

• 「最近のアクティビティが低いポッドリングを見つけて、それらを12ヶ月のトレンドと比較して。」

• 「バス係数やレビュアーの多様性の懸念について、手動でレビューすべきポッドリングはどれですか？」

開発

一般的なタスクは make を通じて利用可能です：

make format
make lint
make typecheck
make test
make coverage
make check

注意事項

• このサーバーは、すでに生成されたレポートファイルをクエリします。Apacheのアップストリーム収集スクリプトは実行しません。

• ここでのワークスペースにはローカルの reports/ ディレクトリが含まれていなかったため、サーバーはApacheのレポートディレクトリのローカルクローンまたはコピーされたスナップショットを受け入れるように構築されています。

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• compare_windowsC
• get_report_markdownB
• get_report_summaryB
• get_window_metricsB
• health_overviewB
• list_metricsB
• list_podlingsB
• query_metric_rankingsC