Apache Health MCP
This server allows you to query and analyze Apache Incubator podling health reports from local Markdown files, providing insights into project activity, trends, and community health metrics.
Overview: Get a high-level summary of available reports (count, podling list, latest generation date) via
health_overview.List & Search Podlings: List all podlings with available reports, or search by case-insensitive substring (with optional result limits) via
list_podlings/search_podlings.Report Access: Retrieve a parsed metrics summary or the raw Markdown source for any podling via
get_report_summary/get_report_markdown.Window-Specific Metrics: Fetch metrics for a podling within a specific time window (e.g.,
3m,6m,12m,to-date), including normalized trend indicators (up,down,flat) viaget_window_metrics.Cross-Window Comparison: Compare a podling's metrics side-by-side across two or three time windows to identify trends via
compare_windows.Metric Rankings: Rank all podlings by a specific metric (e.g.,
commits,prs_merged,dev_messages,bus50,median_merge_days) within a given window viaquery_metric_rankings.List Supported Metrics & Windows: Discover all available metric names and time windows for querying via
list_metrics.
Provides tools for querying Apache Incubator health reports, including listing available podling reports, searching podling names, getting parsed summaries, retrieving raw Markdown reports, comparing metrics across windows, and ranking podlings by various metrics.
Provides access to Apache health reports stored in GitHub repositories, specifically parsing Markdown reports from the Apache Incubator repository's tools/health/reports directory.
Parses and processes Apache health reports stored in Markdown format, extracting structured data from the report files including window details, metrics, and podling information.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apache Health MCP show me the health summary for Amoro"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apache Health MCP
This repo contains a small MCP server for querying the Apache Incubator health reports from tools/health/reports.
It parses the Markdown report format used by Apache's health tooling and exposes MCP tools for:
listing available podling reports
searching podling names
getting a parsed summary for one podling
returning the raw Markdown report
returning metrics for one specific window
comparing one podling across two or three windows
listing supported metrics and windows
ranking podlings by a metric within a window like
3m,6m, or12m
Expected input
Point the server at a local directory containing Markdown files like:
reports/
Amoro.md
Iggy.md
...The parser is designed around the current Apache report structure, especially the ## Window Details section.
Related MCP server: IPMC MCP
Install
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install .For local development:
make install-devRun
health-mcp --reports-dir /path/to/incubator/tools/health/reportsThe server uses stdio, so it is intended to be launched by an MCP client.
For local development without installing first, you can still launch the stdio server directly:
python3 server.pyThe package also keeps apache-health-mcp as a backwards-compatible command alias.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json and add:
{
"mcpServers": {
"apache-health": {
"command": "health-mcp",
"args": [
"--reports-dir",
"/path/to/incubator/tools/health/reports"
]
}
}
}Then restart Claude Desktop. If you installed into a virtual environment that is not on your PATH, use the absolute path to that environment's health-mcp command.
MCP tools
health_overview
Returns the reports directory, report count, podling list, and latest generated date.
list_podlings
Returns the podling names available in the reports directory.
search_podlings
Searches podling names by case-insensitive substring with an optional result limit.
get_report_summary
Returns parsed window metrics for a single podling.
get_report_markdown
Returns the raw Markdown for a single podling report.
get_window_metrics
Returns metrics for one podling and one window such as 3m, 6m, 12m, or to-date, including normalized trend words like up, down, and flat under trends.
compare_windows
Returns side-by-side metrics for one podling across two or three windows, including normalized trend words under each window's trends.
query_metric_rankings
Ranks podlings by a parsed metric such as commits, prs_merged, dev_messages, bus50, or median_merge_days.
list_metrics
Returns the supported metric names and available windows for querying.
Usage Examples
These examples show the kinds of questions a user can ask an MCP client connected to this server.
Reviewing A Report Snapshot
"What Apache Incubator health reports are available in this checkout?"
"How many podling health reports do we have, and when were they generated?"
"Which podlings have health reports I can query?"
"What health metrics and report windows can I ask about?"
Investigating One Podling
"Show me the health summary for Amoro."
"What does the latest health report say about Iggy?"
"Find podlings with names containing 'stream' and summarize the best match."
"For this podling, show the recent 3-month health metrics."
"Show me the original Markdown report for Amoro so I can check the source."
Comparing Trends Across Windows
"Compare Amoro's 3-month, 6-month, and 12-month activity."
"Is Iggy's development activity improving or slowing down?"
"Compare recent mailing-list activity with the longer-term trend for this podling."
"Has this podling's PR merge activity changed between the 3-month and 12-month windows?"
"Is the bus factor for this podling getting better or worse across the report windows?"
Finding Podlings By Activity Signal
"Which podlings had the most dev-list messages in the last 3 months?"
"Show me podlings with no commits in the last 3 months."
"Which podlings have the longest median PR merge time?"
"Rank podlings by merged PRs over the 6-month window."
"Find podlings with low reviewer diversity in the recent report window."
Preparing A Human Review Queue
"Give me a short list of podlings that may need mentor attention based on recent activity."
"Which podlings look quiet across commits, PRs, and dev-list messages?"
"Find podlings with low recent activity and compare them against their 12-month trend."
"Which podlings should I manually review for bus-factor or reviewer-diversity concerns?"
Development
Common tasks are available through make:
make format
make lint
make typecheck
make test
make coverage
make checkNotes
This server queries already-generated report files. It does not run Apache's upstream collection script.
The workspace here did not include a local
reports/directory, so the server is built to accept any local clone or copied snapshot of Apache's reports directory.
Available Tools
9 toolscompare_windowsC
Compare one podling across two or three windows.
get_report_markdownB
Return the raw markdown for one podling report.
get_report_summaryB
Get parsed metrics for one podling report.
get_window_metricsB
Return metrics for a single podling/window combination.
health_overviewB
Return a high-level summary of the available Apache health reports.
list_metricsB
Return the supported metrics and windows for querying.
list_podlingsB
List podlings that have a parsed markdown report.
query_metric_rankingsC
Rank podlings by one parsed metric for a specific window.
search_podlingsB
Search podling names by case-insensitive substring.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose with no overlap: compare_windows compares podlings across windows, get_report_markdown retrieves raw markdown, get_report_summary provides parsed metrics, get_window_metrics gives metrics for a single podling/window, health_overview offers a high-level summary, list_metrics enumerates supported metrics/windows, list_podlings lists podlings with reports, query_metric_rankings ranks podlings by metric, and search_podlings searches podling names. The descriptions unambiguously differentiate each tool's function.
All tools follow a consistent verb_noun or verb_adjective_noun pattern using snake_case: compare_windows, get_report_markdown, get_report_summary, get_window_metrics, health_overview, list_metrics, list_podlings, query_metric_rankings, and search_podlings. The naming is predictable and readable throughout, with no deviations or mixed conventions.
With 9 tools, the count is well-scoped for the Apache health reporting domain. Each tool earns its place by covering distinct aspects such as listing, retrieving, comparing, searching, and ranking podling health data. This is neither too thin nor too heavy, providing comprehensive functionality without bloat.
The tool surface offers complete coverage for querying and analyzing Apache podling health reports. It includes listing and searching podlings, retrieving raw and parsed report data, comparing across windows, getting metrics and rankings, and providing overviews. There are no obvious gaps; agents can perform full workflows from discovery to detailed analysis without dead ends.
Related MCP Connectors
Market data tools for the MCP ecosystem: server stats, events, search, leaderboards, package trends.
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
MCP server for the Seline Analytics API
MCP server for Withings health data — sleep, activity, heart, and body metrics.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn 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.22MIT
- AlicenseAqualityBmaintenanceA dependency-free MCP server for Apache Incubator PMC oversight that helps identify podlings needing attention, assess graduation readiness, and generate podling briefings by combining lifecycle data and community health signals.212MIT
- AlicenseAqualityDmaintenanceAn MCP server for analyzing startup financial health and generating metrics reports locally.2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for comprehensive PyPI package intelligence, providing tools for dependency analysis, security scanning, health scoring, license compliance, and trend tracking.MIT