IPMC MCP

Ein kleiner, abhängigkeitsfreier MCP-Server für Ansichten zur Aufsicht durch das Apache Incubator PMC.

Er setzt sich zusammen aus:

• Podling-Lebenszyklusdaten von PodlingsMCP

• Community- und Berichtssignalen von apache-health

Er stellt meinungsbasierte Tools auf Incubator-Ebene bereit, um das IPMC zu unterstützen bei:

• der Identifizierung von Podlings, die Aufmerksamkeit benötigen

• der Bewertung der Abschlussreife

• der Erstellung von Podling-Briefings

• der Kennzeichnung von notwendigen Mentoring-Interventionen

• der Zusammenfassung von Mustern der Community-Gesundheit über Podlings hinweg

Anforderungen

• Python 3.12+

Related MCP server: Podlings MCP

Ausführen

python3 server.py

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

Installation

python3 -m pip install -e .

Für Entwicklungstools:

python3 -m pip install -e .[dev]

Beispiel-Konfiguration für den MCP-Client

{
 "mcpServers": {
 "ipmc": {
 "command": "python3",
 "args": [
 "/Users/justinmclean/IncubatorMCP/server.py",
 "--podlings-mcp-repo",
 "/Users/justinmclean/PodlingsMCP",
 "--health-mcp-repo",
 "/Users/justinmclean/HealthMCP",
 "--health-source",
 "/Users/justinmclean/incubator/tools/health/reports"
 ]
 }
 }
}

Die Standard-Laufzeitumgebung geht davon aus, dass die zugehörigen Quell-MCP-Repositories und Gesundheitsberichte unter folgenden Pfaden verfügbar sind:

• /Users/justinmclean/PodlingsMCP

• /Users/justinmclean/HealthMCP

• reports, sofern nicht --health-source festgelegt ist

Tool-Aufrufe können die Quelldatenpfade auch mit podlings_source und health_source überschreiben.

Konfigurieren Sie die MCP-Quellorte und das Verzeichnis für Gesundheitsberichte mit Startargumenten:

• --podlings-mcp-repo: Pfad zum PodlingsMCP-Checkout

• --health-mcp-repo: Pfad zum HealthMCP-Checkout

• --health-source: Standardverzeichnis für apache-health-Berichte

Testen

python3 -m unittest discover -s tests -v

Abdeckung

python3 -m coverage run -m unittest discover -s tests
python3 -m coverage report -m

Die Abdeckung ist auf das lokale ipmc-Paket beschränkt, sodass importierte MCPs von Drittanbietern den Bericht nicht verwässern.

Architektur

Siehe docs/architecture.md für das Modullayout, den Laufzeitablauf und die Teststruktur.

Tools

ipmc_watchlist

Gibt Podlings zurück, die basierend auf kombinierten Lebenszyklus- und Gesundheitssignalen am dringendsten die Aufmerksamkeit des IPMC benötigen.

Argumente:

• podlings_source: optionale URL oder lokaler Dateipfad für podlings.xml

• health_source: optionales Berichtsverzeichnis für apache-health-Markdown-Berichte

• as_of_date: optionales YYYY-MM-DD-Datum für zeitabhängige Ansichten

• limit: optionale maximale Anzahl der Ergebnisse

• severity_at_least: optionaler Filter für die Mindestschwere

• include_reasons: optionale Liste von Grundfiltern

graduation_readiness

Bewertet, ob ein Podling für den Abschluss bereit, fast bereit oder noch nicht bereit erscheint.

Argumente:

• podling: erforderlicher Podling-Name

• podlings_source

• health_source

• as_of_date

• include_evidence: optionaler boolescher Wert, standardmäßig true

• strict_mode: optionaler boolescher Wert

podling_brief

Gibt ein auf das IPMC ausgerichtetes Briefing für einen Podling zurück.

Argumente:

• podling: erforderlicher Podling-Name

• podlings_source

• health_source

• as_of_date

• focus: optionale Liste von Bereichen

• brief_format: optional summary oder detailed

mentoring_attention_needed

Gibt Podlings zurück, bei denen eine Mentoring-Intervention notwendig erscheint.

Argumente:

• podlings_source

• health_source

• as_of_date

• limit: optionale maximale Anzahl der Ergebnisse

• urgency_at_least: optionaler Filter für die Mindestdringlichkeit

• include_causes: optionale Liste von Ursachenfiltern

community_health_summary

Gibt eine Zusammenfassung der Community-Gesundheitsmuster über Podlings hinweg auf IPMC-Ebene zurück.

Argumente:

• podlings_source

• health_source

• as_of_date

• scope: optional all_podlings, active_podlings oder reporting_podlings

• group_by: optional none, risk_band, mentor_load oder age_band

• include_examples: optionaler boolescher Wert

Standards

• Wenn weggelassen, verwendet podlings_source standardmäßig die ASF podlings.xml-URL.

• Wenn weggelassen, verwendet health_source --health-source oder reports, falls dieses Startargument nicht gesetzt ist.

• Aufsichtsansichten konzentrieren sich standardmäßig auf aktuelle Podlings.

• Die Gesundheitsanalyse bevorzugt das aktuellste verfügbare Zeitfenster in dieser Reihenfolge: 3m, 6m, 12m, to-date.

Meinungsmodell

Dieser Server hält Quellfakten von abgeleiteten Meinungen getrennt. Risiko- und Bereitschaftsansichten werden abgeleitet aus:

• Mentorenabdeckung

• Zuverlässigkeit der Berichterstattung

• Signalen zur Mentor-Abzeichnung

• Community-Aktivität

• Sichtbarkeit von Releases

• Dauer der Inkubation

• Breite der Beteiligung

Die resultierenden Ausgaben sollen das Urteilsvermögen des IPMC unterstützen, nicht ersetzen.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• community_health_summaryC
• configure_sourcesA
• cross_source_mismatchesB
• current_podlings_overviewB
• graduation_readinessB
• ipmc_watchlistA
• mentoring_attention_neededA
• podling_briefB