Apache Health MCP

此仓库包含一个小型 MCP 服务器，用于查询来自 tools/health/reports 的 Apache Incubator 健康报告。

它解析 Apache 健康工具所使用的 Markdown 报告格式，并提供以下 MCP 工具：

• 列出可用的孵化项目报告

• 搜索孵化项目名称

• 获取单个孵化项目的解析摘要

• 返回原始 Markdown 报告

• 返回特定时间窗口的指标

• 比较单个孵化项目在两个或三个窗口下的数据

• 列出支持的指标和窗口

• 按窗口（如 3m、6m 或 12m）内的指标对孵化项目进行排名

预期输入

将服务器指向包含 Markdown 文件的本地目录，例如：

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 返回单个孵化项目报告的原始 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 的原始 Markdown 报告，以便我可以检查来源。”

比较跨窗口趋势

• “比较 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