Apache Health MCP

Este repositorio contiene un pequeño servidor MCP para consultar los informes de salud de Apache Incubator desde tools/health/reports.

Analiza el formato de informe Markdown utilizado por las herramientas de salud de Apache y expone herramientas MCP para:

• listar los informes de podlings disponibles

• buscar nombres de podlings

• obtener un resumen analizado para un podling

• devolver el informe Markdown original

• devolver métricas para una ventana específica

• comparar un podling en dos o tres ventanas

• listar métricas y ventanas compatibles

• clasificar podlings por una métrica dentro de una ventana como 3m, 6m o 12m

Entrada esperada

Apunte el servidor a un directorio local que contenga archivos Markdown como:

reports/
 Amoro.md
 Iggy.md
 ...

El analizador está diseñado en torno a la estructura actual de informes de Apache, especialmente la sección ## Window Details.

Related MCP server: IPMC MCP

Instalación

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

Para desarrollo local:

make install-dev

Ejecución

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

El servidor utiliza stdio, por lo que está diseñado para ser iniciado por un cliente MCP.

Para desarrollo local sin instalar primero, aún puede iniciar el servidor stdio directamente:

python3 server.py

El paquete también mantiene apache-health-mcp como un alias de comando compatible con versiones anteriores.

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json y añada:

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

Luego reinicie Claude Desktop. Si instaló en un entorno virtual que no está en su PATH, utilice la ruta absoluta al comando health-mcp de ese entorno.

Herramientas MCP

health_overview Devuelve el directorio de informes, el recuento de informes, la lista de podlings y la última fecha de generación.

list_podlings Devuelve los nombres de los podlings disponibles en el directorio de informes.

search_podlings Busca nombres de podlings mediante una subcadena que no distingue entre mayúsculas y minúsculas con un límite de resultados opcional.

get_report_summary Devuelve métricas de ventana analizadas para un solo podling.

get_report_markdown Devuelve el Markdown original para un informe de un solo podling.

get_window_metrics Devuelve métricas para un podling y una ventana como 3m, 6m, 12m o to-date, incluyendo palabras de tendencia normalizadas como up, down y flat bajo trends.

compare_windows Devuelve métricas lado a lado para un podling en dos o tres ventanas, incluyendo palabras de tendencia normalizadas bajo trends de cada ventana.

query_metric_rankings Clasifica los podlings por una métrica analizada como commits, prs_merged, dev_messages, bus50 o median_merge_days.

list_metrics Devuelve los nombres de las métricas compatibles y las ventanas disponibles para consultar.

Ejemplos de uso

Estos ejemplos muestran los tipos de preguntas que un usuario puede hacer a un cliente MCP conectado a este servidor.

Revisión de una instantánea de informe

• "¿Qué informes de salud de Apache Incubator están disponibles en este checkout?"

• "¿Cuántos informes de salud de podlings tenemos y cuándo se generaron?"

• "¿Qué podlings tienen informes de salud que puedo consultar?"

• "¿Sobre qué métricas de salud y ventanas de informe puedo preguntar?"

Investigación de un podling

• "Muéstrame el resumen de salud de Amoro."

• "¿Qué dice el último informe de salud sobre Iggy?"

• "Busca podlings con nombres que contengan 'stream' y resume la mejor coincidencia."

• "Para este podling, muestra las métricas de salud recientes de 3 meses."

• "Muéstrame el informe Markdown original de Amoro para que pueda verificar la fuente."

Comparación de tendencias entre ventanas

• "Compara la actividad de 3 meses, 6 meses y 12 meses de Amoro."

• "¿La actividad de desarrollo de Iggy está mejorando o disminuyendo?"

• "Compara la actividad reciente de la lista de correo con la tendencia a largo plazo de este podling."

• "¿Ha cambiado la actividad de fusión de PR de este podling entre las ventanas de 3 y 12 meses?"

• "¿El factor bus de este podling está mejorando o empeorando a través de las ventanas de informe?"

Búsqueda de podlings por señal de actividad

• "¿Qué podlings tuvieron la mayor cantidad de mensajes en la lista de desarrollo en los últimos 3 meses?"

• "Muéstrame podlings sin commits en los últimos 3 meses."

• "¿Qué podlings tienen el tiempo medio de fusión de PR más largo?"

• "Clasifica los podlings por PRs fusionados durante la ventana de 6 meses."

• "Encuentra podlings con baja diversidad de revisores en la ventana de informe reciente."

Preparación de una cola de revisión humana

• "Dame una lista corta de podlings que pueden necesitar atención de mentores según la actividad reciente."

• "¿Qué podlings parecen tranquilos en cuanto a commits, PRs y mensajes de la lista de desarrollo?"

• "Encuentra podlings con baja actividad reciente y compáralos con su tendencia de 12 meses."

• "¿Qué podlings debería revisar manualmente por preocupaciones sobre el factor bus o la diversidad de revisores?"

Desarrollo

Las tareas comunes están disponibles a través de make:

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

Notas

• Este servidor consulta archivos de informe ya generados. No ejecuta el script de recopilación ascendente de Apache.

• El espacio de trabajo aquí no incluía un directorio reports/ local, por lo que el servidor está diseñado para aceptar cualquier clon local o instantánea copiada del directorio de informes de 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