______________________________________________________________________

标题：GitRoast MCP服务器表情符号🔥 颜色来源：红色颜色To：黄色 sdk：毕业 sdk版本：“6.0.0” app_file：app.py 固定：false short_description：野蛮幽默的野蛮烤GitHub仓库标签：

主控程序
打造mcp轨道创意
格拉迪奥
GitHub
人工智能
烤
模型上下文协议
双子座

许可证：mit

______________________________________________________________________

🔥 GitRoast MCP服务器

使用人工智能驱动的分析和野蛮的幽默粗暴地烘烤GitHub存储库。

为 MCP 1岁生日黑客马拉松 （轨道1：构建MCP-创意）使用 等级 6 具有原生MCP支持和自定义主题、响应式UI。

![Gradio](https://gradio.app/) ![MCP](https://modelcontextprotocol.io/) ![Python](https://python.org/)

______________________________________________________________________

📺 演示视频

🎥 观看3分钟演示 查看GitRoast的实际操作：分析仓库、生成AI烘焙，并通过MCP与Claude Desktop集成！

______________________________________________________________________

📱 社交媒体

🐦 推特/X帖子 | 💼 LinkedIn帖子 与分享您的烘焙结果 #GitRoast#MCP第一个生日!

______________________________________________________________________

✨ 什么是GitRoast？

GitRoast是一个 模型上下文协议（MCP）服务器 分析GitHub存储库和配置文件，然后生成 野蛮而富有建设性的咆哮 基于：

💀 提交模式 -深夜编码、周末提交、频率分析
📝 消息质量 -懒惰提交（“修复”、“wip”、“asdf”）、清晰度、长度
📄 文档 -README质量、代码示例、安装说明
🏷️ 存储库运行状况 -描述、许可证、主题、存档状态
🏆 成就 -基于图案的尴尬徽章
💡 建议 -非常诚实但有用的反馈

另外： 它作为一个 MCP服务器，使Claude Desktop、Claude Code、Cursor和任何兼容MCP的AI代理都可以访问它！

______________________________________________________________________

🎮 现在就试试！

web界面

在上面输入GitHub存储库URL或用户名
点击 "🔥 烤这个Repo！"
享受这残酷的烤肉吧！

尝试示例：

facebook/react
torvalds/linux
octocat （GitHub个人资料）

作为MCP服务器

将此空间作为MCP服务器连接到Claude Desktop或Cursor：

克劳德桌面版 -编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "gitroast": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sse-client",
        "https://YOUR_USERNAME-gitroast-mcp.hf.space/gradio_api/mcp/"
      ]
    }
  }
}

光标 -编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gitroast": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sse-client",
        "https://YOUR_USERNAME-gitroast-mcp.hf.space/gradio_api/mcp/"
      ]
    }
  }
}

替换 YOUR_USERNAME 使用您的Hugging Face用户名。

然后问克劳德或Cursor：

Use GitRoast to analyze the repository facebook/react

______________________________________________________________________

🏆 MCP 1岁生日黑客马拉松

轨道： 轨道1-构建MCP（创意） 标签： building-mcp-track-creative

为什么选择GitRoast？

✅ 新型MCP用例 -第一台用于代码烘焙的MCP服务器 ✅ 谷歌Gemini集成 -AI烘焙的赞助商技术 ✅ 教育+娱乐 -从残酷的反馈中学习 ✅ 生产准备就绪 -内置Gradio 4.x稳定的MCP支持 ✅ 通用兼容性 -适用于任何MCP客户端

是什么让它与众不同

独特的概念 -通过MCP用AI烘焙代码（没有其他人这样做！）
双重分析模式 -分析单个存储库或整个用户配置文件
综合分析 -每个存储库跟踪10+个指标
智能回退 -AI使用模板回退进行烘焙（始终有效）
成就系统 -带有尴尬徽章的游戏化反馈
整洁架构 -记录良好、类型安全、可维护的代码

判断标准一致性

标准	GitRoast如何交付
完整性	✅ HF空间+社交帖子+文档+演示视频
设计/UI-UX	✅ 干净的Gradio 4.x界面，直观的工作流程
功能	✅ 稳定的Gradio 4.x MCP，AI集成，双模
创造力	✅ 新颖概念：用AI幽默烘焙代码
文档	✅ 全面的README+演示视频
现实世界影响	✅ 对开发人员的教育反馈

______________________________________________________________________

📊 特性

综合分析

提交模式检测：

深夜提交（晚上11点至凌晨5点）
周末编码频率
提交消息质量评分
修复/WIP/合并提交比率
作者数量和贡献模式

文件质量：

README的完整性和长度
代码示例存在
安装说明
许可证检测
存储库主题/标签

存储库运行状况：

有意义的描述检查
许可证验证
主题/标签完整性
存档/废弃检测
星/叉/问题指标

人工智能烘焙

Google Gemini集成：

基于实际图案的创意个性化烘焙
为您的代码量身定制的上下文感知幽默
粗鲁但有建设性的反馈
多种烘焙类别（每次分析6-10种）

模板回退：

预先写好的野蛮人为了常见的图案而咆哮
在没有API密钥的情况下工作
仍然有趣且有用
即时结果

成就体系：

“吸血鬼代码妖精”（深夜提交太多）
“周末囚犯”（代码外没有生命）
“提交战争罪犯信息”（懒惰信息）
“工业Bug工厂”（修复提交过多）
还有10多个尴尬的徽章！

建设性建议：

残酷诚实但可行的建议
工作流程的具体改进
最佳做法建议
文档提示

双重分析模式

存储库分析：

深入了解单个存储库
分析所有提交（最多1000个）
README和元数据审查
详细模式检测

剖面分析：

分析用户的整个编码历史
聚合来自所有公共存储库的数据
跨存储库模式检测
识别跨项目的编码习惯

______________________________________________________________________

🛠️ 技术栈

MCP集成：

等级 4.44.1 -稳定的MCP服务器支持(mcp_server=True)
模型上下文协议1.22.0 -符合标准协议
服务器发送事件（SSE）-实时通信
JSON-RPC-请求/响应处理

AI和API：

谷歌双子座 -AI烤一代（双生-2.5-flash）
-存储库和提交数据
使用指数回退重试逻辑
速率限制处理（60/hr→ 5000/hr与令牌）

UI和设计：

自定义渐变4.x主题（橙色/红色渐变的软主题）
高对比度文本输入，实现完美可视性
具有面板变体的响应式布局
通过CSS媒体查询支持黑暗模式
简洁、现代的界面，针对可读性进行了优化

核心技术：

Python 3.8+-类型安全实现
Gradio 4.44.1-Web用户界面和MCP服务器
requests -HTTP客户端
python-dotenv -环境管理

______________________________________________________________________

🔑 API密钥（可选）

这个空间工作 使用API密钥:

GitHub代币

优点：

将速率限制从每小时60个请求增加到5000个请求
允许分析更多存储库
更快地分析配置文件

如何获得：

首选
生成新令牌（经典）
不需要范围 （我们只阅读公共repos）
复制令牌

如何使用：

输入上面的“可选API键”手风琴，或
添加为空间机密： GITHUB_TOKEN

Gemini API密钥

优点：

人工智能生成的创意烘焙
基于你的模式的个性化幽默
比模板好（但模板仍然很好！）

如何获得：

首选谷歌人工智能工作室
使用Google帐户登录
创建API密钥
复制密钥

如何使用：

输入上面的“可选API键”手风琴，或
添加为空间机密： GEMINI_API_KEY

______________________________________________________________________

🚀 使用示例

示例1：分析一个流行的存储库

输入： facebook/react

输出：

🔥 GitRoast Results - Grade: B

Pretty good! Not perfect, but you're not actively making the world worse.

📦 Repository: facebook/react
- Stars: 220,000+
- Language: JavaScript

📊 Quick Stats
- Total Commits: 15,234
- Late Night Commits: 4,870 (32%)

🔥 The Roasts (6)

1. 🦉 Certified Nocturnal Disaster 🔥🔥🔥🔥🔥
32% of your commits are between 11 PM and 5 AM...
[Full roast content]

🏆 Achievements (3)
- 🌙 Vampire Code Goblin
  4,870 commits made while humanity sleeps...

💡 Suggestions
- Get some sleep. Your code quality drops 50% after midnight...

示例2：分析GitHub配置文件

输入： octocat

输出： 分析所有公共存储库，结合统计数据，识别跨存储库模式，并生成全面的配置文件。

示例3:MCP与Claude的集成

用户： “使用GitRoast分析我的仓库github.com/myuser/myproject”

克劳德： *调用GitRoast MCP服务器*

GitRoast： 返回完整的分析，包括烘焙、成就和建议

克劳德： 以对话形式呈现结果，可以讨论模式，回答有关分析的问题

______________________________________________________________________

📖 设置和安装

促进地方发展

克隆存储库：

   git clone https://github.com/Umang00/Git-Roast-MCP.git
   cd Git-Roast-MCP

安装依赖项：

   pip install -r requirements.txt

设置环境（可选）：

   cp .env.example .env
   # Edit .env with your API keys

运行服务器：

   python app.py

访问权限：

- Web用户界面：http://localhost:7860 - MCP端点：http://localhost:7860/gradio_api/mcp/

用于MCP客户端集成

克劳德桌面：

{
  "mcpServers": {
    "gitroast": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sse-client",
        "http://localhost:7860/gradio_api/mcp/"
      ]
    }
  }
}

重新启动Claude Desktop并询问：

Use GitRoast to analyze facebook/react

光标IDE： 编辑 ~/.cursor/mcp.json 具有与上述相同的配置。

任何MCP客户端： 连接到： http://localhost:7860/gradio_api/mcp/ 使用SSE传输

______________________________________________________________________

🏗️ 建筑

┌─────────────────────┐
│  MCP Clients        │
│  (Claude Desktop,   │
│   Cursor, etc.)     │
└──────────┬──────────┘
           │ stdio
           ↓
┌─────────────────────┐
│  NPX Bridge         │
│  server-sse-client  │
└──────────┬──────────┘
           │ HTTP/SSE
           ↓
┌─────────────────────┐
│  Gradio MCP Server  │
│  (app.py)           │
│  - Stable Gradio 4.x │
│  - mcp_server=True  │
└──────────┬──────────┘
           │
           ↓
┌─────────────────────┐
│  analyze_repo()     │
│  (logic.py)         │
│  - Type-safe        │
│  - Docstrings       │
│  - Error handling   │
└──────────┬──────────┘
           │
      ┌────┴────┐
      ↓         ↓
┌──────────┐ ┌──────────┐
│ GitHub   │ │ Gemini   │
│   API    │ │   API    │
└──────────┘ └──────────┘

关键设计决策：

稳定Gradio 4.x MCP -可靠的实施
清洁分离 -UI（app.py）+逻辑（Logic.py）
类型安全 -MCP兼容性的完整类型提示
智能回退 -如果AI失败，模板将被烘焙
重试逻辑 -API调用的指数退避

______________________________________________________________________

📁 项目结构

git-roast-mcp/
├── app.py                 # Gradio UI + MCP server
├── logic.py               # Analysis & roast generation (1,363 lines)
├── requirements.txt       # Dependencies
├── pyproject.toml         # Project metadata
├── .env.example           # Environment template
├── README.md              # This file
└── docs/                  # Additional documentation
    ├── SETUP.md           # Detailed setup guide
    ├── DEPLOYMENT.md      # Deployment instructions
    └── HACKATHON.md       # Hackathon submission notes

______________________________________________________________________

🐛 故障排除

常见问题

“超出费率限制”

添加GitHub令牌（将限制从60增加到5000 req/hr）
添加为空间机密或在UI中输入

“MCP服务器未连接”

确保Space/server正在运行
检查MCP端点URL是否正确
重新启动MCP客户端（克劳德桌面/光标）
验证 npx 已安装（Node.js附带）

“AI烤一代失败”

检查Gemini API密钥是否有效
别担心-自动回到模板烘焙
模板仍然有趣且有用！

“未找到存储库”

确保存储库是公开的
检查URL格式（所有者/仓库）
请先尝试在浏览器中访问仓库

浏览器错误（正常！）

如果您看到以下错误：

ERROR:mcp.server.streamable_http:Error handling POST request
ClientDisconnect

这很正常！ MCP端点是为MCP客户端（Claude Desktop、Cursor）而不是浏览器设计的。根URL处的web UI工作正常——这些错误仅在浏览器尝试直接访问MCP端点时出现。

______________________________________________________________________

🤝 贡献

这是一个黑客马拉松项目，但欢迎投稿！

复刻仓库
创建要素分支
进行更改
提交拉取请求

贡献想法：

其他烘焙模板
更多成就徽章
支持其他代码托管平台
特定语言分析
代码复杂性度量

______________________________________________________________________

📄 许可证

MIT许可证-有关详细信息，请参阅存储库

______________________________________________________________________

👥 团队

单人开发人员： @Umang00

内置于❤️ 对于MCP社区和可以开玩笑的开发人员来说！

______________________________________________________________________

🙏 致谢

MCP 1岁生日黑客马拉松 -为了机会和灵感
格拉迪奥 -具有原生MCP支持的惊人框架
谷歌双子座 -为AI烘焙提供动力
Anthropic -用于创建MCP协议
GitHub社区 -对于公共API和数据

______________________________________________________________________

⚠️ 免责声明

此工具用于 仅用于娱乐和教育目的.

烤肉的意思是：

✅ 有趣又轻松
✅ 建设性（指出真实模式）
✅ 教育（突出最佳做法）
❌ 不是指精神攻击或人身攻击

负责任地使用，不要太认真！ 😄

记住：最好的开发人员可以嘲笑他们的提交历史，同时从中学习。

______________________________________________________________________

🔗 链接

🏠 现场演示： \[YOUR_HF_SPACE_URL\]
📺 演示视频： \[YOUR_YOUTUBE_LINK\]
💻 github： https://github.com/Umang00/Git-Roast-MCP
🐦 推特： \[你的博客\]
💼 领英： \[你的链接帖子\]
📖 MCP文件： https://modelcontextprotocol.io/
🎨 Gradio MCP指南： https://www.gradio.app/guides/building-mcp-server-with-gradio

______________________________________________________________________

由...制作🔥 和☕ MCP一周年黑客马拉松

轨道1：构建MCP |标签： building-mcp-track-creative

Git Roast MCP

快速接入

详细介绍

🔥 GitRoast MCP服务器

📺 演示视频

📱 社交媒体

✨ 什么是GitRoast？

🎮 现在就试试！

web界面

作为MCP服务器

🏆 MCP 1岁生日黑客马拉松

为什么选择GitRoast？

是什么让它与众不同

判断标准一致性

📊 特性

综合分析

人工智能烘焙

双重分析模式

🛠️ 技术栈

🔑 API密钥（可选）

GitHub代币

Gemini API密钥

🚀 使用示例

示例1：分析一个流行的存储库

示例2：分析GitHub配置文件

示例3:MCP与Claude的集成

📖 设置和安装

促进地方发展

用于MCP客户端集成

🏗️ 建筑

📁 项目结构

🐛 故障排除

常见问题

浏览器错误（正常！）

🤝 贡献

📄 许可证

👥 团队

🙏 致谢

⚠️ 免责声明

🔗 链接

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP