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