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_TOKENMCP客户端配置
光标
添加到 .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等）兼容
许可证
麻省理工学院