Apache Health MCP

Dieses Repository enthält einen kleinen MCP-Server zum Abfragen der Apache Incubator-Gesundheitsberichte aus tools/health/reports.

Er analysiert das von den Apache-Gesundheitstools verwendete Markdown-Berichtsformat und stellt MCP-Tools bereit für:

• das Auflisten verfügbarer Podling-Berichte

• das Suchen nach Podling-Namen

• das Abrufen einer analysierten Zusammenfassung für einen Podling

• das Zurückgeben des rohen Markdown-Berichts

• das Zurückgeben von Metriken für ein spezifisches Zeitfenster

• das Vergleichen eines Podlings über zwei oder drei Zeitfenster hinweg

• das Auflisten unterstützter Metriken und Zeitfenster

• das Ranking von Podlings nach einer Metrik innerhalb eines Zeitfensters wie 3m, 6m oder 12m

Erwartete Eingabe

Verweisen Sie den Server auf ein lokales Verzeichnis, das Markdown-Dateien enthält wie:

reports/
 Amoro.md
 Iggy.md
 ...

Der Parser ist auf die aktuelle Apache-Berichtsstruktur ausgelegt, insbesondere auf den Abschnitt ## Window Details.

Related MCP server: IPMC MCP

Installation

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

Für die lokale Entwicklung:

make install-dev

Ausführung

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

Der Server verwendet stdio und ist daher dafür vorgesehen, von einem MCP-Client gestartet zu werden.

Für die lokale Entwicklung ohne vorherige Installation können Sie den stdio-Server weiterhin direkt starten:

python3 server.py

Das Paket behält außerdem apache-health-mcp als abwärtskompatiblen Befehls-Alias bei.

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json und fügen Sie Folgendes hinzu:

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

Starten Sie anschließend Claude Desktop neu. Wenn Sie die Installation in einer virtuellen Umgebung vorgenommen haben, die sich nicht in Ihrem PATH befindet, verwenden Sie den absoluten Pfad zum health-mcp-Befehl dieser Umgebung.

MCP-Tools

health_overview Gibt das Berichtsverzeichnis, die Anzahl der Berichte, die Podling-Liste und das Datum der letzten Generierung zurück.

list_podlings Gibt die im Berichtsverzeichnis verfügbaren Podling-Namen zurück.

search_podlings Durchsucht Podling-Namen nach einer nicht-case-sensitiven Teilzeichenfolge mit einem optionalen Ergebnislimit.

get_report_summary Gibt analysierte Fenster-Metriken für einen einzelnen Podling zurück.

get_report_markdown Gibt das rohe Markdown für einen einzelnen Podling-Bericht zurück.

get_window_metrics Gibt Metriken für einen Podling und ein Zeitfenster wie 3m, 6m, 12m oder to-date zurück, einschließlich normalisierter Trendwörter wie up, down und flat unter trends.

compare_windows Gibt Metriken für einen Podling im direkten Vergleich über zwei oder drei Zeitfenster hinweg zurück, einschließlich normalisierter Trendwörter unter den trends jedes Fensters.

query_metric_rankings Erstellt ein Ranking von Podlings nach einer analysierten Metrik wie commits, prs_merged, dev_messages, bus50 oder median_merge_days.

list_metrics Gibt die unterstützten Metriknamen und verfügbaren Zeitfenster für Abfragen zurück.

Anwendungsbeispiele

Diese Beispiele zeigen die Arten von Fragen, die ein Benutzer an einen mit diesem Server verbundenen MCP-Client stellen kann.

Überprüfung einer Berichtsmomentaufnahme

• "Welche Apache Incubator-Gesundheitsberichte sind in diesem Checkout verfügbar?"

• "Wie viele Podling-Gesundheitsberichte haben wir und wann wurden sie generiert?"

• "Welche Podlings haben Gesundheitsberichte, die ich abfragen kann?"

• "Über welche Gesundheitsmetriken und Berichtszeitfenster kann ich Informationen abrufen?"

Untersuchung eines einzelnen Podlings

• "Zeige mir die Gesundheitszusammenfassung für Amoro."

• "Was sagt der neueste Gesundheitsbericht über Iggy aus?"

• "Finde Podlings mit Namen, die 'stream' enthalten, und fasse das beste Ergebnis zusammen."

• "Zeige für diesen Podling die Gesundheitsmetriken der letzten 3 Monate."

• "Zeige mir den ursprünglichen Markdown-Bericht für Amoro, damit ich die Quelle überprüfen kann."

Vergleich von Trends über Zeitfenster hinweg

• "Vergleiche die Aktivität von Amoro über 3, 6 und 12 Monate."

• "Verbessert oder verlangsamt sich die Entwicklungsaktivität von Iggy?"

• "Vergleiche die aktuelle Mailinglisten-Aktivität mit dem langfristigen Trend für diesen Podling."

• "Hat sich die PR-Merge-Aktivität dieses Podlings zwischen dem 3-Monats- und dem 12-Monats-Fenster verändert?"

• "Verbessert oder verschlechtert sich der Bus-Faktor für diesen Podling über die Berichtszeitfenster hinweg?"

Finden von Podlings anhand von Aktivitätssignalen

• "Welche Podlings hatten in den letzten 3 Monaten die meisten Nachrichten in der Entwickler-Mailingliste?"

• "Zeige mir Podlings ohne Commits in den letzten 3 Monaten."

• "Welche Podlings haben die längste mediane PR-Merge-Zeit?"

• "Erstelle ein Ranking der Podlings nach zusammengeführten PRs über das 6-Monats-Fenster."

• "Finde Podlings mit geringer Reviewer-Diversität im aktuellen Berichtsfenster."

Vorbereitung einer menschlichen Prüfungs-Warteschlange

• "Gib mir eine kurze Liste von Podlings, die aufgrund ihrer kürzlichen Aktivität möglicherweise die Aufmerksamkeit eines Mentors benötigen."

• "Welche Podlings wirken bei Commits, PRs und Nachrichten in der Entwickler-Mailingliste ruhig?"

• "Finde Podlings mit geringer kürzlicher Aktivität und vergleiche sie mit ihrem 12-Monats-Trend."

• "Welche Podlings sollte ich manuell auf Bedenken hinsichtlich des Bus-Faktors oder der Reviewer-Diversität prüfen?"

Entwicklung

Allgemeine Aufgaben sind über make verfügbar:

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

Hinweise

• Dieser Server fragt bereits generierte Berichtsdateien ab. Er führt nicht das Upstream-Sammlungsskript von Apache aus.

• Der Arbeitsbereich hier enthielt kein lokales reports/-Verzeichnis, daher ist der Server so konzipiert, dass er jeden lokalen Klon oder eine kopierte Momentaufnahme des Apache-Berichtsverzeichnisses akzeptiert.

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