repomind (Drew Drashy)

RepoMind🧠

由GitHub MCP支持的上下文感知存储库管理器

RepoMind是一个智能回购管理器，它结合了 GitHub的官方MCP服务器 带着一个 代码库理解MCP 提供端到端、上下文驱动的开发工作流程。

它就像你的存储库的语义助手——桥接 深入理解代码库 随着 安全的GitHub操作从有针对性的重构到CI指导的修复，RepoMind帮助团队加速开发，同时让人类保持循环。

______________________________________________________________________

🚀 特性

• 🧠 了解你的代码库\

对存储库进行索引，构建语义嵌入，并提供符号搜索、交叉引用和依赖关系图。

• 🔄 安全地自动化更改\

生成差异、创建分支、提交更新，并打开带有结构化解释的拉取请求。

• ✅ CI感知反馈回路\

监控GitHub操作，获取失败日志，并迭代地提出修复建议。

• 🔒 护栏优先\

仅PR模式，最低权限GitHub PAT使用，以及每个代理操作的完整审计日志。

• 📊 仪表盘\

Web UI（Next.js+Tailwind），用于监控仓库索引、代理运行、PR提案和审批。

______________________________________________________________________

🏗️ 系统架构

\[User Prompt / Ticket]
|
v
RepoMind Agent (Node.js)
|
+------------+------------+
\|                         |
\[Codebase MCP]          \[GitHub MCP]
(symbols, refs,         (branches, commits,
search, embeddings)     PRs, issues)
\|                         |
v                         v
\[Qdrant Vector DB]       \[GitHub Actions CI]
\[Postgres Metadata]      (status checks)
\[Redis Queues]

______________________________________________________________________

📦 技术栈

• 前端： Next.js、Tailwind、shadcn/ui（仪表板和审批）
• 后端： Node.js（NestJS/Fastify）、Redis（队列）、PostgreSQL（元数据）、BullMQ
• 矢量搜索： Qdrant（语义代码块）
• MCP服务器：

- GitHub MCP（官方，用于回购+PR操作） - 代码库MCP（语义仓库索引器）

• CI/CD： GitHub操作集成

______________________________________________________________________

⚙️ 入门指南

1.先决条件

• Docker+Docker组合
• GitHub个人访问令牌（PAT） repo 和 read:packages 范围

2.克隆仓库

git clone https://github.com/your-org/repomind.git
cd repomind

3.设置环境变量

创建一个 .env 文件：

GITHUB_TOKEN=ghp_yourtokenhere
POSTGRES_PASSWORD=postgres

4.启动堆栈

docker compose -f infra/docker-compose.yml up --build

这将启动：

• RepoMind Orchestrator API (http://localhost:4000)
• Web仪表板 (http://localhost:3000)
• GitHub MCP服务器 (http://localhost:3333)
• 代码库MCP服务器 (http://localhost:3334)
• Postgres、Redis、Qdrant

5.打开仪表板

访问： http://localhost:3000

______________________________________________________________________

🧩 使用示例

• 让RepoMind重构一个类：

- 代理通过Codebase MCP查找所有引用 - 生成最小补丁 - 通过GitHub MCP开设分支机构+PR

• 处理失败的CI：

- 代理从PR获取CI日志 - 将失败的测试本地化 - 建议修复+更新分支

______________________________________________________________________

🔒 安全

• 默认 仅PR模式 （没有直接推到main）。
• 最低特权PAT 推荐（仅限回购级别）。
• 所有MCP工具调用的完整审计日志。

______________________________________________________________________

📅 路线图

• \[\]面向开发人员的CLI界面
• \[\]通过MCP配置集成VS代码
• \[\]可插入的重构/测试生成/文档“剧本”
• \[\]多回购支持

______________________________________________________________________

🤝 贡献

欢迎投稿！请打开问题或PR。 对于较大的提案，请先展开讨论。

______________________________________________________________________

📜 许可证

麻省理工学院许可证©2025 RepoMind作者