Apache Health MCP

이 저장소는 tools/health/reports에서 Apache Incubator 상태 보고서를 쿼리하기 위한 작은 MCP 서버를 포함하고 있습니다.

이 서버는 Apache의 상태 도구에서 사용하는 마크다운 보고서 형식을 파싱하며, 다음과 같은 MCP 도구를 제공합니다:

• 사용 가능한 포들링 보고서 나열

• 포들링 이름 검색

• 특정 포들링에 대한 파싱된 요약 정보 가져오기

• 원본 마크다운 보고서 반환

• 특정 기간에 대한 지표 반환

• 두세 개의 기간에 걸쳐 포들링 비교

• 지원되는 지표 및 기간 나열

• 3m, 6m, 12m과 같은 기간 내 지표별 포들링 순위 매기기

예상 입력

서버를 다음과 같은 마크다운 파일이 포함된 로컬 디렉토리를 가리키도록 설정하십시오:

reports/
 Amoro.md
 Iggy.md
 ...

이 파서는 현재 Apache 보고서 구조, 특히 ## Window Details 섹션을 중심으로 설계되었습니다.

Related MCP server: IPMC MCP

설치

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

로컬 개발 환경:

make install-dev

실행

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

이 서버는 stdio를 사용하므로 MCP 클라이언트에 의해 실행되도록 설계되었습니다.

먼저 설치하지 않고 로컬에서 개발하는 경우, 여전히 stdio 서버를 직접 실행할 수 있습니다:

python3 server.py

이 패키지는 하위 호환성을 위해 apache-health-mcp라는 명령 별칭도 유지합니다.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json을 편집하고 다음을 추가하십시오:

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

그런 다음 Claude Desktop을 다시 시작하십시오. PATH에 없는 가상 환경에 설치한 경우, 해당 환경의 health-mcp 명령에 대한 절대 경로를 사용하십시오.

MCP 도구

health_overview 보고서 디렉토리, 보고서 수, 포들링 목록 및 최신 생성 날짜를 반환합니다.

list_podlings 보고서 디렉토리에 있는 포들링 이름을 반환합니다.

search_podlings 대소문자를 구분하지 않는 부분 문자열로 포들링 이름을 검색하며, 선택적으로 결과 제한을 설정할 수 있습니다.

get_report_summary 단일 포들링에 대해 파싱된 기간별 지표를 반환합니다.

get_report_markdown 단일 포들링 보고서의 원본 마크다운을 반환합니다.

get_window_metrics 3m, 6m, 12m 또는 to-date와 같은 특정 포들링 및 기간에 대한 지표를 반환하며, trends 아래에 up, down, flat과 같은 정규화된 추세 단어를 포함합니다.

compare_windows 각 기간의 trends 아래에 정규화된 추세 단어를 포함하여, 두세 개의 기간에 걸쳐 포들링에 대한 지표를 나란히 비교하여 반환합니다.

query_metric_rankings commits, prs_merged, dev_messages, bus50, median_merge_days와 같이 파싱된 지표별로 포들링 순위를 매깁니다.

list_metrics 쿼리에 지원되는 지표 이름과 사용 가능한 기간을 반환합니다.

사용 예시

이 예시들은 사용자가 이 서버에 연결된 MCP 클라이언트에 질문할 수 있는 유형을 보여줍니다.

보고서 스냅샷 검토

• "이 체크아웃에서 사용할 수 있는 Apache Incubator 상태 보고서는 무엇인가요?"

• "포들링 상태 보고서가 몇 개나 있으며, 언제 생성되었나요?"

• "쿼리할 수 있는 상태 보고서가 있는 포들링은 무엇인가요?"

• "어떤 상태 지표와 보고서 기간에 대해 질문할 수 있나요?"

단일 포들링 조사

• "Amoro의 상태 요약을 보여줘."

• "Iggy에 대한 최신 상태 보고서 내용은 무엇인가요?"

• "이름에 'stream'이 포함된 포들링을 찾아서 가장 적합한 것을 요약해줘."

• "이 포들링에 대해 최근 3개월간의 상태 지표를 보여줘."

• "출처를 확인할 수 있도록 Amoro의 원본 마크다운 보고서를 보여줘."

기간별 추세 비교

• "Amoro의 3개월, 6개월, 12개월 활동을 비교해줘."

• "Iggy의 개발 활동이 개선되고 있나요, 아니면 둔화되고 있나요?"

• "이 포들링의 최근 메일링 리스트 활동과 장기적인 추세를 비교해줘."

• "이 포들링의 PR 병합 활동이 3개월 기간과 12개월 기간 사이에서 변했나요?"

• "이 포들링의 버스 팩터(bus factor)가 보고서 기간 동안 개선되고 있나요, 아니면 악화되고 있나요?"

활동 신호로 포들링 찾기

• "지난 3개월 동안 개발자 메일링 리스트 메시지가 가장 많았던 포들링은 무엇인가요?"

• "지난 3개월 동안 커밋이 없는 포들링을 보여줘."

• "중앙값 PR 병합 시간이 가장 긴 포들링은 무엇인가요?"

• "6개월 기간 동안 병합된 PR 기준으로 포들링 순위를 매겨줘."

• "최근 보고서 기간에 리뷰어 다양성이 낮은 포들링을 찾아줘."

사람의 검토 대기열 준비

• "최근 활동을 바탕으로 멘토의 주의가 필요할 수 있는 포들링 목록을 짧게 알려줘."

• "커밋, PR, 개발자 메일링 리스트 메시지 전반에서 활동이 저조해 보이는 포들링은 무엇인가요?"

• "최근 활동이 저조한 포들링을 찾아 12개월 추세와 비교해줘."

• "버스 팩터나 리뷰어 다양성 문제로 수동 검토해야 할 포들링은 무엇인가요?"

개발

일반적인 작업은 make를 통해 수행할 수 있습니다:

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

참고

• 이 서버는 이미 생성된 보고서 파일을 쿼리합니다. Apache의 업스트림 수집 스크립트를 실행하지 않습니다.

• 이 작업 공간에는 로컬 reports/ 디렉토리가 포함되어 있지 않으므로, 서버는 Apache 보고서 디렉토리의 로컬 클론이나 복사된 스냅샷을 수용하도록 빌드되었습니다.

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