Client MCP Server

🚀 GitHub 仓库助手

GitHub 仓库助手是一款借助 MCP（模型控制协议）将 Claude 与 GitHub 仓库相连接的实用工具。它能帮助用户对代码进行分析，并在创建部署工作流等任务上提供有力支持。

🚀 快速开始

本工具使用模型控制协议（MCP）使 Claude 与 GitHub 仓库交互，以下是快速使用步骤：

git clone <your-repo-url>
cd <repo-directory>
pip install -r requirements.txt

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

ANTHROPIC_API_KEY=your_api_key_here

启动 Streamlit 应用程序：

streamlit run app.py

✨ 主要特性

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

📦 安装指南

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），然后点击“分析仓库”。

高级用法

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

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

📚 详细文档

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

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

🔧 技术细节

本工具主要依赖 Python 3.13 或更高版本，需要安装 Git 且确保其在 PATH 中可用，同时需要 Anthropic API 密钥。通过 MCP 协议，Claude 可以利用 MCP 服务器提供的工具与 GitHub 仓库进行交互，实现代码分析和任务生成等功能。

⚠️ 局限性说明

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