GitHub 仓库助手

一个使用 MCP（模型控制协议）连接 Claude 和 GitHub 仓库的工具，允许用户分析代码并获得创建部署工作流等任务的帮助。

特性

• 克隆和分析任意 GitHub 仓库
• 通过 Claude 3.5 Sonnet 与仓库交互
• 请求部署工作流和其他代码生成任务
• 通过 Streamlit 前端实现无缝集成
• 配备专门工具的 MCP 服务器，用于仓库交互

需求

• Python 3.13 或更高版本
• Git 已安装且 PATH 可用
• Anthropic API 密钥

安装

1. 克隆此仓库：

   git clone <your-repo-url>
   cd <repo-directory>
   

2. 安装所需的依赖项：

   pip install -r requirements.txt
   

3. 在 .env 文件中设置您的 Anthropic API 密钥：

   ANTHROPIC_API_KEY=your_api_key_here
   

使用方法

1. 启动 Streamlit 应用程序：

   streamlit run app.py
   

2. 在侧边栏中，通过在“服务器脚本路径”字段中输入 server.py 文件的路径并点击“连接到服务器”来连接到 MCP 服务器。

3. 输入一个 GitHub 仓库 URL（例如，https://github.com/deploypilotorg/example-repo），然后点击“分析仓库”。

4. 一旦仓库被分析，您可以通过提问或请求以下任务与之交互：

   • “此仓库中有哪些文件？”
   • “main.py 文件的作用是什么？”
   • “为这个代码创建一个 GitHub Actions 部署工作流”
   • “生成此应用程序的 Dockerfile”

工作原理

该应用程序使用模型控制协议（MCP）使 Claude 能够通过专门工具与 GitHub 仓库交互：

1. MCP 服务器 (server.py) 提供用于克隆、分析和读取 GitHub 仓库的工具
2. Streamlit 前端 (app.py) 提供用户友好的交互界面
3. Claude 使用提供的工具来理解仓库结构并生成相关响应

局限性

• 当前仅支持公共 GitHub 仓库
• 大型仓库可能需要更长时间才能克隆和分析
• 生成的部署工作流可能需要根据具体要求进行手动调整