适合谁
- 需要快速响应 GitHub 数据的开发者
- 希望减少 GitHub API 调用成本和延迟的项目
- 使用 Convex 和 Next.js 的技术栈团队
F
50FMRS · D
FasterGH 是一个技术成熟的 GitHub 镜像工具，但它并非官方 MCP Server，且需要用户自行部署和配置后端。它提供了丰富的操作工具和实时数据缓存，但可能更适合有经验的开发者。
FasterGH 是一个 GitHub 镜像界面，使用 Convex 作为实时缓存/同步层，确保 GitHub 是数据源，Convex 提供低延迟读取模型。它通过 Webhook 实时更新，并在仓库接入时从 GitHub REST API 回填历史数据，提供了优化的读取界面，页面加载时不直接调用 GitHub API。支持通过乐观变更进行写入操作，如创建 Issue、评论、合并 PR。适合需要高频访问 GitHub 数据的开发者，尤其是那些希望减少 API 调用延迟和次数的人。
工具能力
connectRepo
连接一个 GitHub 仓库进行镜像
listRepos
列出所有镜像的仓库
listPRs
列出某个仓库的拉取请求
listIssues
列出某个仓库的问题
getActivity
获取活动流相关数据
createIssue
创建新的 GitHub Issue
createComment
在 Issue 或 PR 上创建评论
mergePR
合并一个拉取请求
adminHealth
获取系统健康状态和表计数
安装接入
- 克隆仓库并安装依赖:
bun install。2. 复制环境变量文件:cp .env.example .env，并设置 GITHUB_WEBHOOK_SECRET、CONVEX_DEPLOYMENT 和 NEXT_PUBLIC_CONVEX_URL。3. 设置 Convex 环境变量：在packages/database目录下运行bunx convex env set GITHUB_PAT "$(gh auth token)"和bunx convex env set GITHUB_WEBHOOK_SECRET "<your-webhook-secret>"。4. 启动开发服务器:bun dev。5. 使用connectRepo变异连接 GitHub 仓库。6. 设置仓库级 Webhook 指向 Convex 部署的/api/github/webhook端点。
选型与风险
不适合谁
- 需要完整 GitHub 功能的用户
- 不希望部署额外后端服务的个人
- 非开发者或技术用户
所需权限
- 需要 GitHub Personal Access Token (PAT) 且具有 `repo` 权限，以读取和写入仓库数据
- 需要 Convex 部署和相应的环境变量
- 需要能够接收 Webhook 的公开端点
风险与副作用
- 由于镜像数据可能滞后，存在在同步间隙中读取到过期数据的风险
- 如果 Webhook 配置不正确，可能导致数据不一致
- 需要维护 Convex 数据库和 Webhook 基础设施，增加了运维复杂性
常见排障
- 确保 GitHub PAT 有效且具有 `repo` 权限。检查 Webhook 配置是否正确指向 Convex 的 `/api/github/webhook` 且 secret 匹配。检查 Convex 部署状态和环境变量。查看日志中的错误并运行测试套件。
使用场景
快速浏览 GitHub Pull Request 列表
实时查看 GitHub Issue 更新
创建评论和合并 PR 的操作
监控仓库活动流
支持客户端
Claude Desktop完整支持