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

한 포들링에 대한 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