使用说明
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.打开仪表板
🧩 使用示例
-
让RepoMind重构一个类：
- 代理通过Codebase MCP查找所有引用
- 生成最小补丁
- 通过GitHub MCP开设分支机构+PR
-
处理失败的CI：
- 代理从PR获取CI日志
- 将失败的测试本地化
- 建议修复+更新分支
🔒 安全
- 默认 仅PR模式 （没有直接推到main）。
- 最低特权PAT 推荐（仅限回购级别）。
- 所有MCP工具调用的完整审计日志。
📅 路线图
- []面向开发人员的CLI界面
- []通过MCP配置集成VS代码
- []可插入的重构/测试生成/文档“剧本”
- []多回购支持
🤝 贡献
欢迎投稿！请打开问题或PR。 对于较大的提案，请先展开讨论。
📜 许可证
麻省理工学院许可证©2025 RepoMind作者
