GitHub Webhook MCP

github webhook mcp

通过Cloudflare Worker+持久对象为Claude提供实时GitHub webhook通知。

建筑

GitHub ──POST──▶ Cloudflare Worker ──▶ Durable Object (SQLite)
                                           │
                                           ├── MCP tools (Streamable HTTP)
                                           ├── WebSocket real-time stream
                                           │
                          ┌────────────────┘
                          │
     Desktop / Codex: .mcpb local bridge ──▶ polling via MCP tools
     Claude Code CLI: .mcpb local bridge ──▶ WebSocket → channel notifications

• Cloudflare工作人员 接收GitHub webhooks，验证签名，将事件存储在SQLite的持久对象中。
• 本地MCP桥 （.mcpb）将工具调用代理到Worker，并可选择通过WebSocket连接以获得实时通道通知。
• 无需本地webhook接收器或隧道。

先决条件

入门指南

1.安装GitHub应用程序

安装 GitHub Webhook MCP 您的GitHub组织或帐户上的应用程序：

1. 访问
2. 选择要安装的组织或帐户
3. 选择要授予访问权限的存储库（或所有存储库）
4. 批准请求的权限

注： 当应用程序在更新后请求新权限时，您必须在GitHub通知或应用程序的安装设置中批准它们。在接受权限之前，Webhooks不会被传递。

重要提示： 不要为同一端点创建单独的存储库webhook。GitHub应用程序处理所有webhook交付——存储库webhook会导致重复或格式错误的请求。

2.设置MCP客户端

继续 安装指南 将您的AI助手连接到webhook服务。

安装

请参阅 安装维基页面 有关完整的设置指南，包括：

• 快速开始 使用预览实例
• MCP客户端设置 适用于Claude Desktop、Claude Code CLI和Codex
• 自助托管指南 用于Cloudflare Workers部署

用法示例

示例1：检查挂起的webhook状态

用户提示：

“有新的GitHub通知吗？”

预期产量： AI呼叫 get_pending_status 并返回摘要：

You have 3 pending webhook events:
- 2 push events
- 1 pull_request event

示例2：检查特定事件

用户提示：

“显示最新拉取请求事件的详细信息。”

预期产量： AI呼叫 list_pending_events 找到PR事件，然后 get_event 使用事件ID检索完整有效载荷：

PR #42 "Fix login timeout" was opened by @alice in repo acme/web-app
  Branch: fix/login-timeout → main
  Status: open
  Changed files: 3

示例3：审核后处理事件

用户提示：

“我已经查看了所有推送通知，并将其标记为已完成。”

预期产量： AI呼叫 list_pending_events 要查找推送事件，则 mark_processed 对于每一个：

Marked 2 push events as processed:
- Push to main by @bob (3 commits)
- Push to develop by @alice (1 commit)

示例4：通过webhooks监控CI状态

用户提示：

“CI检查通过了我最近的PR吗？”

预期产量： AI呼叫 list_pending_events 寻找 check_run 与公关相关的事件，然后 get_event 详细信息：

CI results for PR #42 "Fix login timeout":
- build (ubuntu-latest): ✓ passed
- lint: ✓ passed
- test (node-18): ✓ passed
All checks passed.

MCP工具

单体仓库结构

worker/       — Cloudflare Worker + Durable Objects
local-mcp/    — Local stdio MCP bridge (TypeScript, dev)
mcp-server/   — .mcpb package for Claude Desktop
shared/       — Shared types and utilities

隐私政策

事件存储在Cloudflare持久对象（边缘存储）中。本地MCP网桥代理工具调用Worker，不在本地存储事件数据。

• 扩展隐私政策：https://smgjp.com/privacy-policy-github-webhook-mcp/

支持

• GitHub问题：https://github.com/Liplus-Project/github-webhook-mcp/issues
• 维基 （英文）
• 要求： docs/0-requirements.md

相关

• Liplus项目/Liplus语言 --Li+语言规范