数据统计仪表盘生成工具

一个静态数据统计仪表盘生成工具,整合GitHub星标数和MCP注册表数据,支持本地生成和持续部署。

  • by Mossaka
  • HTML
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Mossaka/mcp-stats

使用说明

MCP 统计数据仪表板

这个仓库生成一个单一的静态仪表板,它结合了两个数据源:

  • 列出的链接 reference/servers.md – 根据GitHub实时星标数和提及频率排名。
  • 公共MCP注册表(https://registry.modelcontextprotocol.io) – 按名称过滤至最新服务器,补充了包下载量(npm、PyPI、NuGet、GitHub发布)和仓库星标数。

使用方法

本地生成

python scripts/mcp_registry_report.py \
  --github-token <your_github_token> \
  --output mcp_registry_stats.html

需要GitHub令牌以避免在获取仓库星标数和发布下载统计数据时达到速率限制。如果未提供,则设置 GITHUB_TOKEN 或者 GITHUB_PERSONAL_ACCESS_TOKEN 在环境中。

持续部署

工作流程中的 .github/workflows/deploy-pages.yml 每次推送时运行 main,按需(workflow_dispatch),并且每晚(都这样做)。它

  1. 检出仓库。
  2. 安装 Python 3.11 及 requests 依赖。
  3. 生成 dist/index.html 和;与 scripts/mcp_registry_report.py 使用自动提供的 GITHUB_TOKEN。
  4. 将结果发布到GitHub Pages。

启用“GitHub Actions”作为源来配置GitHub Pages,以使网站可用。

文件概览

  • scripts/mcp_registry_report.py – 主脚本,用于收集数据并生成综合的HTML报告。
  • mcp_registry_stats.html – 生成的仪表板(被忽略的 .gitignore 如果你在本地重新生成的话)。
  • .github/workflows/deploy-pages.yml – GitHub Actions 管道用于自动构建和部署。

请随意调整时间安排、添加缓存或扩展数据源以定制仪表板。*** 补丁结束