MCP GitHub Agent

🚀 GitSense。AI：自主提交分析器和Webhook代理

 ](https://nodejs.org/) 

GitSense。AI是一个自托管、离线、零成本的AI替代代理，它监听GitHub推送，使用高速NLP基于规则的引擎对代码更改进行分类，并主动确保开发团队永远不会丢失文档上下文。

如果后端或前端团队推动 主要特征 而无需随后更新存储库的 README.mdGitSense。AI会立即向团队的Discord服务器或电子邮件收件箱发出格式丰富的警报，总结确切的提交并ping团队以记录他们的更改。

______________________________________________________________________

✨ 核心功能

• ⚡ 零延迟分析：完全离线运行，无需昂贵的API调用（无需Claude、OpenAI或SaaS订阅）。
• 🧠 语义分类引擎：解析提交消息并立即将其放入6个主要DevOps模板的原生管道：

- 🚀 功能增强 - 🐛 错误修复 - 🔒 安全补丁 - ♻️ 重构和优化 - 📦 依赖关系更新 - 📝 文件调整

• 🚨 智能文档警报：将分类为“功能”的推送与Git差异进行交叉引用，以查看 README.md 被修改了。如果错过，它会发出警报。
• 🔔 无摩擦集成：对Discord Webhooks（不需要机器人令牌）和Nodemailer（SMTP/Gmail）的开箱即用支持。
• 🌍 隧道准备就绪：旨在通过Cloudflare安全地暴露(cloudflared)或本地隧道。

______________________________________________________________________

🛠️ 工作原理（生命周期）

1. 触发器：开发人员运行 git push 在您的存储库中。
2. 拦截：GitHub通过互联网向Cloudflare隧道发送JSON Webhook有效负载。
3. 验证：GitSense。AI拦截有效载荷，使用您的密钥验证SHA-256 HMAC签名。
4. 发动机：丢弃分支/已删除的提交，并将原始提交消息管道到 analyzerService.js.
5. 裁决：代理决定类别。如果 Features > 0 以及 readmeModified 旗是 false，它会构建一个警报包。
6. 调度: notificationService.js 将格式精美的markdown数据包路由到您配置的Discord频道和/或电子邮件。

______________________________________________________________________

💻 技术栈

• 运行时间： Node.js、Express.js、Python
• 网络与安全： 加密（用于Webhook签名验证的HMAC SHA-256）
• Git操作： GitHub Webhooks API， @octokit/rest
• 通知层： Discord REST Webhooks， nodemailer （SMTP）
• 隧道工程（开发）： Cloudflare(cloudflared)
• 模型上下文协议

______________________________________________________________________

🚀 快速入门指南

1.安装

克隆存储库并安装所需的软件包：

git clone https://github.com/YOUR_USERNAME/mcp-github-agent.git
cd mcp-github-agent
npm install

2.配置

创建环境文件：

cp .env.example .env

填充 .env 使用您的安全凭据：

• GITHUB_WEBHOOK_SECRET：与您的GitHub配置匹配的安全短语。
• DISCORD_WEBHOOK_URL：（可选）您的Discord频道webhook。
• EMAIL_USER / EMAIL_PASS：（可选）Nodemailer/Gmail应用程序密码。

3.在本地运行代理

启动主Express服务器：

npm start

4.创建Webhook隧道

在新的终端窗口中，安全地暴露您的localhost：

cloudflared tunnel --url http://localhost:3000

复制生成的 https://*.trycloudflare.com URL。

5.连接到GitHub

1. 导航到您的GitHub存储库-> 设置 -> 网络钩子 -> 添加Webhook.
2. 有效载荷URL: /api/webhook
3. 内容类型: application/json
4. 秘密：您的 GITHUB_WEBHOOK_SECRET.
5. 事件：只是 push 活动。

______________________________________________________________________

📋 Discord警报示例

🚨 Documentation Alert: New Features in DevWidSiddxx/frontend-app
A team member pushed to main without updating the README.

Here's what was merged (Auto-Categorized):

📊 **Commit Analysis Report** 📊

🚀 **Feature Enhancement**:
  - feat: implement new secure login gateway
  - add: stripe payment processing