Skip to main content
Glama

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の判断をサポートすることを目的としており、判断を置き換えるものではありません。

Available Tools

21 tools
community_health_summaryC

Return an IPMC-level summary of community health across podlings, including strong patterns, risks, and mentoring-capacity signals.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

configure_sourcesA

Set or inspect process-level source defaults so later IPMC tool calls can omit source override arguments.

Inputs: podlings_source, health_source, report_source, mail_source, +3 more.

cross_source_mismatchesB

Return concrete mismatches between cached report narrative and current health or release evidence.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

current_podlings_overviewB

Return a factual overview of current Incubator podlings from podlings.xml lifecycle metadata.

Inputs: podlings_source, as_of_date, limit, include_descriptions.

graduation_readinessB

Assess whether a podling appears ready, near ready, or not yet ready for graduation.

Inputs: podling (required), podlings_source, health_source, report_source, +5 more.

ipmc_watchlistA

Return podlings that most need IPMC attention based on combined lifecycle and health signals.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

mentoring_attention_neededA

Return podlings where mentoring intervention appears necessary, with urgency and likely causes.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

podling_briefB

Return an IPMC-oriented briefing for a single podling, including status, trajectory, and attention areas.

Inputs: podling (required), podlings_source, health_source, report_source, +5 more.

recent_changesC

Return per-podling recent deltas the IPMC should scan, excluding unchanged or static fields.

Inputs: podlings_source, health_source, report_source, mail_source, +4 more.

refresh_mail_cacheC

Refresh cached general@incubator.apache.org message summaries used by IPMC mail evidence tools.

Inputs: mail_source, mail_api_base, mail_timespan, query, +1 more.

refresh_report_cacheB

Refresh cached ASF Incubator report data used by IPMC report-narrative tools.

Inputs: report_source, years, full_history, limit, +2 more.

release_artifact_evidenceB

Return ReleaseMCP artifact, sidecar, cadence, Incubator naming evidence, and optional release-page and GitHub/Docker Hub/PyPI/Maven distribution hints for one podling.

Inputs: podling (required), release_dist_base, release_archive_base, release_max_depth, +6 more.

release_visibilityB

Return release-governance visibility concerns, including no releases and activity/release mismatches.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

release_vote_evidenceB

Return MailMCP release vote/result thread evidence for one podling alongside IPMC release visibility signals.

Inputs: podling (required), podlings_source, health_source, report_source, +5 more.

reporting_cohortB

Return current reporting podlings grouped into non-ranked IPMC review buckets: reporting issues, release visibility issues, recent significant changes, and no obvious concerns.

Inputs: podlings_source, health_source, report_source, mail_source, +3 more.

reporting_gapsB

Return podlings with Incubator reporting compliance gaps, excluding activity analysis.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

reporting_reliabilityB

Return objective reporting reliability patterns over time, separating one-off late reporting from repeated late or missing reporting.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

reporting_scheduleB

Return expected Incubator reporting cadence, due-this-month status, and next expected reporting period from PodlingsMCP.

Inputs: podlings_source, podling, as_of_date, report_month, +2 more.

report_narrative_signalsB

Return report-derived narrative signals such as latest reported issues, recurring issues, low observed mentor sign-off, and release visibility mismatches.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

significant_changesC

Return a structured factual subset of recent changes: no 12-month releases, large activity shifts, and newly visible reporting or release transitions.

Inputs: podlings_source, health_source, report_source, mail_source, +5 more.

stalled_podlingsB

Return podlings that match the strict low-delivery, no-release stalled definition.

Inputs: podlings_source, health_source, report_source, mail_source, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 21 tools

    Disambiguation5/5

    Each tool has a clearly defined and distinct purpose, focusing on specific aspects of IPMC oversight such as community health, podling status, releases, reporting, or mentoring. There is no ambiguity between tools.

    Naming Consistency5/5

    All tool names follow a consistent pattern of descriptive phrases using underscores (e.g., community_health_summary, graduation_readiness). No mixing of camelCase or other conventions is observed.

    Tool Count4/5

    With 21 tools, the server covers a broad domain of IPMC responsibilities. While the count is relatively high, each tool addresses a necessary function, and the scope justifies the number.

    Completeness4/5

    The tool set provides comprehensive coverage of IPMC information needs, including community health, podling lifecycle, releases, reporting, and mentoring. Minor gaps may exist for direct actions, but the analysis surface is thorough.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server for accessing and analyzing Apache Software Foundation Incubator podling data from podlings.xml. It provides tools to query podling metadata, generate statistics, and analyze incubation trends over time.
      22
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for querying and analyzing Apache Incubator podling health reports. It provides tools to list, search, and compare podling metrics across different time windows from Apache's health report Markdown files.
      9
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for comprehensive PyPI package intelligence, providing tools for dependency analysis, security scanning, health scoring, license compliance, and trend tracking.
      MIT