GitHub仓库导航工具

一个基于AI的GitHub仓库导航和分析工具,帮助用户快速理解仓库结构、代码依赖和影响分析。

  • by humanize-platform
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 humanize-platform/mcp_agent_hackathon_e2b

使用说明

🧠 人工智能驱动的GitHub回购导航器

GitHub存储库的AI原生入职和影响分析助手。

该工具使用完整的 MCP(模型上下文协议) 工具链——在 E2B沙箱 --直接检查您的存储库。它可以:

  • 浏览文件夹和文件
  • 阅读并总结代码
  • 解释架构和依赖关系
  • 帮助您推断更改文件时的影响

所有这一切都是通过一个简单的 格拉迪奥 web UI。


🚀 这个代理做什么

给定GitHub存储库URL和您的问题,代理:

  1. 旋转一个 E2B沙箱 配置有:
    • githubOfficial MCP(GitHub聊天)
    • exa MCP(用于外部文件/背景)
  2. 通过某种方式连接到该沙盒 MCP HTTP网关.
  3. 使用 OpenAI代理SDK 致:
    • 列出并浏览存储库中的目录
    • 打开并分析源文件
    • 总结模块和服务的行为
    • 回答有关函数在哪里使用以及组件如何连接的问题
  4. 使用以下命令在聊天风格的Gradio界面中返回答案 Chatbot(type="messages").

🔍 没有产生幻觉的文件或API –一切都基于MCP GitHub工具在存储库中实际看到的内容。


💡 为什么这很有用(特别是对于支持/AMS)

此代理专为 现实世界的工程团队特别是:

  • 新加入者/入职:在几分钟内了解项目结构、关键模块以及它们是如何组合在一起的。
  • 支持和AMS团队:
    • 快速跟踪功能或服务的使用位置。
    • 请参阅依赖关系和跨文件影响。
    • 问:“如果我更改了这个文件,还有什么可能会损坏?”并获得文件级、基于代码的见解。
  • 大型系统维护人员:导航复杂的存储库,而无需手动挖掘数十个文件和目录。

把它看作是 虚拟高级工程师 谁:

  • 了解回购结构,
  • 可以按需打开和读取任何文件,
  • 并根据以下内容回答问题 实际代码不是记忆。

🧱 技术栈

  • python
  • 格拉迪奥 –网络用户界面/聊天界面
  • E2B沙箱 –隔离的程序化沙盒环境
  • MCP(模型上下文协议):
    • githubOfficial –浏览和阅读GitHub仓库
    • exa –外部知识/文档搜索(可选但受支持)
  • OpenAI代理SDK –核心推理/编排
  • Dotenv。 –用于环境变量管理

⚙️ 环境变量

脚本需要这些环境变量(例如,通过 .env 文件):

E2B_API_KEY=your_e2b_api_key
GITHUB_API_KEY=your_github_personal_access_token
OPENAI_API_KEY=your_openai_api_key
EXA_API_KEY=your_exa_api_key   # optional, but recommended if you want EXA MCP