AI导哈

GitHub贡献分析服务

一个用于展示交互式GitHub贡献热图、统计数据和用户档案的MCP服务器，适用于开发者和团队协作场景。

  • by okisdev
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 okisdev/mcp-app-github-contributions

使用说明

GitHub贡献MCP服务器

一个模型上下文协议（MCP）服务器，显示交互式GitHub贡献热图、统计数据和用户配置文件。建于 荣誉 并部署在 Cloudflare员工.

特性

  • 交互式贡献热图（类似于GitHub配置文件）
  • 贡献统计（总计、连续、日平均）
  • 用户资料显示，包括关注者和转发数
  • 黑暗/光明主题支持
  • 逐年捐款明细
  • 响应式设计

先决条件

发展

# Install dependencies
pnpm install

# Start development server
pnpm dev

服务器运行于 http://localhost:8787

部署

# Deploy to Cloudflare Workers
pnpm deploy

# Set GitHub token (optional, for higher API rate limits)
npx wrangler secret put GITHUB_TOKEN

MCP客户端配置

光标

添加到 .cursor/mcp.json （项目）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "github-contributions": {
      "url": "https://your-worker.workers.dev/mcp"
    }
  }
}

通过身份验证：

{
  "mcpServers": {
    "github-contributions": {
      "url": "https://your-worker.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MCP_AUTH_TOKEN}"
      }
    }
  }
}

克劳德桌面

添加到您的Claude Desktop MCP配置中：

{
  "mcpServers": {
    "github-contributions": {
      "url": "https://your-worker.workers.dev/mcp"
    }
  }
}

API终点

端点 方法 描述
/ GET 交互式web用户界面
/mcp ALL MCP可流式HTTP传输端点
/api/contributions/:username 获取 用于贡献数据的REST API
/health GET 健康检查

MCP工具

github_contributions

显示交互式GitHub贡献小部件。

参数：

  • username （字符串，可选）：用于获取贡献的GitHub用户名。如果没有提供，UI中将显示一个输入字段。

退货： MCP App HTML组件，带有贡献热图和统计数据。

环境变量

变量 描述 必填
GITHUB_TOKEN 用于更高API速率限制的GitHub个人访问令牌 否（推荐）

传输协议

此服务器使用 可流式HTTP传输 通过 @hono/mcp:

  • 单端点(/mcp)适用于所有MCP操作
  • 无状态请求处理
  • SSE流媒体支持
  • 与现代MCP客户端（Cursor、Claude Desktop等）兼容

许可证

麻省理工学院

相关 MCP