GitHub Repository Analysis Tool

基本能力

产品定位

GitHub Repository Analysis Tool 是一个用于分析和洞察 GitHub 仓库的工具，特别适合开发者和团队用于代码仓库的管理和优化。

核心功能

• 仓库信息分析：获取 GitHub 仓库的详细信息。
• 提交历史分析：分析提交历史以识别模式和洞察。
• AI 驱动的洞察：利用 Ollama 生成基于仓库数据的智能响应和分析。
• 美观的命令行界面：提供用户友好的 CLI 进行交互。
• 基于 MCP 的客户端-服务器架构：采用模块化架构，高效获取和分析数据。

适用场景

• 开发者需要快速了解仓库的元数据和统计信息。
• 团队希望分析提交历史以优化开发流程。
• 需要基于 AI 的智能分析来生成仓库的深度洞察。

工具列表

• get_repo_info：获取仓库信息。
• get_commit_history：获取提交历史用于分析。

常见问题解答

• 如何设置 GitHub 个人访问令牌？
• 创建令牌后，通过环境变量 GITHUB_TOKEN 设置。
• 如何运行 Ollama-only 模式？
• 使用 --disable-tools 参数运行客户端。

使用教程

使用依赖

• Python 3.10 或更高版本
• 安装 Ollama 并配置 qwen2.5:7b 模型
• GitHub 个人访问令牌（用于更高的 API 速率限制）

安装教程

1. 克隆仓库： bash git clone https://github.com/frangkli/github-analysis.git cd github-analysis
2. 设置环境和依赖： bash uv sync
3. 激活虚拟环境： bash source .venv/bin/activate
4. 安装 Ollama：确保已安装 Ollama 并配置 qwen2.5:7b 模型。
5. 设置 GitHub 个人访问令牌： bash export GITHUB_TOKEN=your_token_here

调试方式

1. 启动服务器： bash github-analysis server
2. 运行客户端： bash github-analysis client <owner> <repo>
3. Ollama-only 模式： bash github-analysis client <owner> <repo> --disable-tools

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。