GitHub MCP AI Repo Analyzer

GitHub MCP AI回购分析器

这个项目是一个基于Django的仓库文档生成器，由代理AI提供支持，集成了GitHub MCP服务器工具包。它总结了任何GitHub存储库的结构、开放问题、拉取请求和分支，生成清晰的Markdown和HTML输出。

______________________________________________________________________

概述

分析公共或私有GitHub存储库，并使用AI和MCP CLI工具生成简洁的文档。代理工作流使用OpenAI获取和汇总数据，并在浏览器中显示结果。

______________________________________________________________________

示例输出

请参阅为GitHub MCP Server仓库生成的示例文档：

• HTML报告示例

上面的示例文件说明了此工具如何可视化存储库结构、未解决的问题、拉取请求等。

______________________________________________________________________

快速启动

1. 构建MCP服务器和CLI工具

git clone https://github.com/github/github-mcp-server.git
cd github-mcp-server
go build -o github-mcp-server ./cmd/github-mcp-server
go build -o mcpcurl ./cmd/mcpcurl

将这两个二进制文件复制到Django项目根目录中：

cp github-mcp-server mcpcurl /path/to/your/project/

1. 设置环境变量

• 创建一个 .env 项目根目录中的文件：

  OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1. 安装Python依赖项

pip install -r requirements.txt

1. 运行服务器

python manage.py runserver 127.0.0.1:8000

1. 访问 http://127.0.0.1:8000 在您的浏览器中。

______________________________________________________________________

特性

• 带有可点击树的存储库结构摘要。
• 发布和拉取请求获取和摘要。
• 分行列表。
• 人工智能驱动的Markdown和HTML文档。

______________________________________________________________________

故障排除

• 对于空结果或“401错误凭据”，请检查您的GitHub令牌：
• 必须正确，未过期，并且 repo 和 user 范围。
• 对于二进制错误，请重新生成 mcpcurl 和 github-mcp-server 对于您的操作系统。
• 确保你的 .env 值与shell中加载的值匹配。

______________________________________________________________________

参考文献

• OpenAI API文档
• Django文档