MCP App GitHub Contributions

GitHub贡献MCP服务器

特性

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

先决条件

• Node.js 18+

发展

# 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终点

MCP工具

github_contributions

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

参数：

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

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

环境变量

传输协议

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

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

许可证

麻省理工学院