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 倉庫。
• 大型倉庫可能需要更長時間才能克隆和分析。
• 生成的部署工作流可能需要根據具體要求進行手動調整。