IPMC MCP

Apache Incubator PMCの監視ビューのための、依存関係のない小さなMCPサーバーです。

以下のデータを構成します：

• PodlingsMCP からのポッドリングのライフサイクルデータ

• apache-health からのコミュニティおよびレポートのシグナル

IPMCを支援するための、インキュベーターレベルの独自のツールを提供します：

• 注意が必要なポッドリングの特定

• 卒業準備状況の評価

• ポッドリングのブリーフィング作成

• メンターによる介入が必要な箇所のフラグ立て

• ポッドリング全体のコミュニティ健全性パターンの要約

要件

• Python 3.12+

Related MCP server: Podlings MCP

実行

python3 server.py

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

インストール

python3 -m pip install -e .

開発ツールの場合：

python3 -m pip install -e .[dev]

MCPクライアント設定例

{
 "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"
 ]
 }
 }
}

デフォルトのランタイムは、兄弟ソースMCPリポジトリおよびヘルスレポートが以下に存在することを前提としています：

• /Users/justinmclean/PodlingsMCP

• /Users/justinmclean/HealthMCP

• reports （--health-source が設定されていない場合）

ツール呼び出しでは、podlings_source および health_source を使用してソースデータパスを上書きすることも可能です。

ソースMCPの場所とヘルスレポートディレクトリを起動引数で設定します：

• --podlings-mcp-repo: PodlingsMCP チェックアウトへのパス

• --health-mcp-repo: HealthMCP チェックアウトへのパス

• --health-source: デフォルトの apache-health レポートディレクトリ

テスト

python3 -m unittest discover -s tests -v

カバレッジ

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

カバレッジはローカルの ipmc パッケージに限定されているため、インポートされた兄弟MCPによってレポートが希釈されることはありません。

アーキテクチャ

モジュールのレイアウト、ランタイムフロー、テスト構造については docs/architecture.md を参照してください。

ツール

ipmc_watchlist

ライフサイクルと健全性のシグナルを組み合わせて、IPMCの注意が最も必要なポッドリングを返します。

引数：

• podlings_source: podlings.xml のオプションのURLまたはローカルファイルパス

• health_source: apache-health マークダウンレポート用のオプションのレポートディレクトリ

• as_of_date: 期間に依存するビューのためのオプションの YYYY-MM-DD 日付

• limit: 結果の最大数のオプション

• severity_at_least: 最小重大度フィルターのオプション

• include_reasons: 理由フィルターリストのオプション

graduation_readiness

ポッドリングが卒業に向けて準備ができているか、準備に近いか、まだ準備ができていないかを評価します。

引数：

• podling: 必須のポッドリング名

• podlings_source

• health_source

• as_of_date

• include_evidence: オプションのブール値、デフォルトは true

• strict_mode: オプションのブール値

podling_brief

1つのポッドリングに対するIPMC向けのブリーフィングを返します。

引数：

• podling: 必須のポッドリング名

• podlings_source

• health_source

• as_of_date

• focus: オプションの領域リスト

• brief_format: オプションの summary または detailed

mentoring_attention_needed

メンターによる介入が必要と思われるポッドリングを返します。

引数：

• podlings_source

• health_source

• as_of_date

• limit: 結果の最大数のオプション

• urgency_at_least: 最小緊急度フィルターのオプション

• include_causes: 原因フィルターリストのオプション

community_health_summary

ポッドリング全体のコミュニティ健全性パターンのIPMCレベルの要約を返します。

引数：

• podlings_source

• health_source

• as_of_date

• scope: オプションの all_podlings、active_podlings、または reporting_podlings

• group_by: オプションの none、risk_band、mentor_load、または age_band

• include_examples: オプションのブール値

デフォルト

• 省略した場合、podlings_source はASFの podlings.xml URLをデフォルトとします。

• 省略した場合、health_source は --health-source を使用するか、その起動引数が設定されていない場合は reports を使用します。

• 監視ビューはデフォルトで現在のポッドリングに焦点を当てます。

• ヘルス分析は、3m、6m、12m、to-date の順序で、利用可能な最新のウィンドウを優先します。

オピニオンモデル

このサーバーは、ソースとなる事実と導き出された意見を分離しています。リスクと準備状況のビューは以下から導き出されます：

• メンターのカバー範囲

• レポートの信頼性

• メンターの承認シグナル

• コミュニティの活動

• リリースの可視性

• インキュベーション期間

• 参加の広がり

得られた出力はIPMCの判断をサポートすることを目的としており、判断を置き換えるものではありません。

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