MCP Server Demo

🚀 GitHub 代碼審查 MCP 服務

本服務是一個由Claude驅動的AI服務，可對GitHub倉庫進行代碼審查。藉助模型上下文協議（MCP），它能實現與外部數據源和工具的無縫集成，為用戶提供全面且專業的代碼審查體驗。

🚀 快速開始

此服務提供了一系列工具，使用戶能夠：

1. 提交GitHub倉庫以進行代碼審查
2. 獲取對代碼庫的詳細反饋和建議
3. 針對特定領域（例如安全、性能、最佳實踐）集中審查
4. 跟蹤審查歷史並訪問之前的審查結果

✨ 主要特性

• 倉庫分析：通過提供URL即可分析GitHub倉庫
• 專注審查：可選指定審查關注的區域（例如“安全、性能、最佳實踐”）
• 改進建議：獲得改進代碼庫的具體建議
• 文件級分析：針對特定文件獲取詳細反饋
• 安全掃描：識別安全漏洞並提供修復建議
• 依賴分析：分析項目依賴以發現過時包和潛在漏洞
• 代碼質量指標：洞察代碼複雜度、重複率和維護性
• 性能分析：識別性能瓶頸並提優化建議
• 最佳實踐比較：將代碼與行業最佳實踐進行對比（可指定框架）
• 拉取請求描述生成：自動生成全面的拉取請求描述
• Cascade提示生成：創建可用於實施改進的Cascade特定提示

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/your-repository.git
   

2. 設置虛擬環境並安裝依賴：

   python -m venv env
   source env/bin/activate  # 在Windows上使用`env\Scripts\activate`
   pip install -r requirements.txt
   

3. 啟動服務器：

   python main.py
   

💻 使用示例

基礎用法

以下是一些常見操作的命令示例：

1. 審查倉庫：

   Please review the GitHub repository at https://github.com/username/repo-name
   

2. 集中審查特定領域：

   Review https://github.com/username/repo-name with focus on security and performance
   

3. 獲取改進建議：

   Suggest improvements for the repository https://github.com/username/repo-name
   

4. 列出已審查倉庫：

   Show me all the repositories that have been reviewed
   

5. 生成Cascade提示：

   Generate a Cascade prompt for the improvements to https://github.com/username/repo-name
   

6. 獲取改進後的代碼：

   Show me improved code for the file src/components/Button.js in https://github.com/username/repo-name
   

📚 詳細文檔

MCP 工具

此MCP服務器提供以下工具：

倉庫審查工具

• review_repository(repo_url: str, focus_areas: Optional[str] = None)：通過URL提交倉庫以進行審查，可選指定關注區域。
• list_reviewed_repositories()：列出所有已審查的倉庫。

改進建議工具

• suggest_improvements(repo_url: str)：對指定倉庫提出改進建議。
• get_improvement_details(repo_url: str, file_path: str)：獲取特定文件的改進詳細信息。

安全與性能工具

• scan_for_vulnerabilities(repo_url: str)：掃描倉庫中的安全漏洞。
• analyze_performance(repo_url: str)：分析倉庫的性能問題。

代碼生成工具

• generate_improved_code(repo_url: str, file_path: str)：為指定文件生成改進後的代碼。
• create_cascade_prompt(repo_url: str)：創建可用於實施改進的Cascade提示。

📄 許可證

本項目採用 MIT 許可證。

🔗 參考資料

• 模型上下文協議（MCP）Python SDK - 構建MCP提供程序的官方Python SDK