← 返回目录

FasterGH

社区

基于 Convex 实时缓存的快速 GitHub 镜像界面

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 258 / 438
Stars: ★ 157 热门
传输方式: stdio（本地进程）
运行环境: Bun 1.0+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 7 个月前 ⚠
工具数: 9

50FMRS · D

FasterGH 是一个技术成熟的 GitHub 镜像工具，但它并非官方 MCP Server，且需要用户自行部署和配置后端。它提供了丰富的操作工具和实时数据缓存，但可能更适合有经验的开发者。

最强项 · 安全与权限 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

10/20

文档质量

11/20

安装易用性

9/20

查看各项评分依据

可靠性 8/20: 该项目结构清晰，包含大量测试（52个集成测试和1个冒烟测试），表明关键路径可能可复现。但未提供实际的CI工作流文件作为可验证的执行证据，且未执行代码，因此可靠性得分上限为12。另外，README声称是MCP服务器，但实际是Next.js应用和Convex后端，缺少MCP服务器清单或工具定义文件，存在矛盾，导致可靠性得分低于10。
安全与权限 12/20: README要求用户提供GitHub PAT，但未明确最小权限，且建议使用'gh auth token'可能具有过广的权限。代码中很可能存在凭据处理，但未提供确凿证据。存在webhook secret和外部网络调用，但未提供数据流披露或确认机制。未发现红色警告，但权限最小化和确认机制不明确，因此得分中等。
维护活跃度 10/20: 仓库有MIT许可证，且有更新记录（README提到测试命令）。但未提供版本发布、提交频率或依赖更新策略的证据。没有明确的安全响应渠道。作为较新的项目，维护活跃度尚可，但缺乏版本管理和安全披露的细节。
文档质量 11/20: README提供了详细的架构说明、设置步骤、测试命令和项目结构，但缺少MCP特定的文档，如工具定义、参数说明、限制和故障排除。未提供实例或配置示例用于客户端连接。文档整体可用，但隐藏了MCP服务器身份的假设，存在诚信问题。
安装易用性 9/20: README提供了从安装到连接仓库的步骤，包括环境变量和Convex设置。但缺少MCP客户端的配置示例，且实际是Web应用而非MCP服务器，安装路径可能误导。由于未提供可验证的测试，根据静态校准规则，安装得分上限为15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要快速响应 GitHub 数据的开发者
希望减少 GitHub API 调用成本和延迟的项目
使用 Convex 和 Next.js 的技术栈团队

不适合谁

需要完整 GitHub 功能的用户
不希望部署额外后端服务的个人
非开发者或技术用户

所需权限

需要 GitHub Personal Access Token (PAT) 且具有 `repo` 权限，以读取和写入仓库数据
需要 Convex 部署和相应的环境变量
需要能够接收 Webhook 的公开端点

风险与副作用

由于镜像数据可能滞后，存在在同步间隙中读取到过期数据的风险
如果 Webhook 配置不正确，可能导致数据不一致
需要维护 Convex 数据库和 Webhook 基础设施，增加了运维复杂性

安装接入

准备工作

运行环境：Bun 1.0+

GITHUB_PAT 必填密钥 GitHub 个人访问令牌，需要 repo 权限，可通过 gh auth token 获取或到 GitHub 设置页生成。

GITHUB_WEBHOOK_SECRET 必填密钥 Webhook 签名密钥，可用 openssl rand -hex 32 生成，需与 GitHub 仓库 hook 配置一致。

CONVEX_DEPLOYMENT 必填 Convex 部署标识，在 Convex 控制台或 convex dev 部署时获得。

NEXT_PUBLIC_CONVEX_URL 必填 Convex 后端的公共访问 URL，由 Convex 部署提供。

其他可选配置项（1 个）

CONVEX_SITE_URL 可选 Convex HTTP 端点站点 URL，用作 GitHub webhook 的回调地址。

克隆仓库并安装依赖: bun install。
复制环境变量文件: cp .env.example .env，并设置 GITHUB_WEBHOOK_SECRET、CONVEX_DEPLOYMENT 和 NEXT_PUBLIC_CONVEX_URL。
设置 Convex 环境变量：在 packages/database 目录下运行 bunx convex env set GITHUB_PAT "$(gh auth token)" 和 bunx convex env set GITHUB_WEBHOOK_SECRET "<your-webhook-secret>"。
启动开发服务器: bun dev。
使用 connectRepo 变异连接 GitHub 仓库。
设置仓库级 Webhook 指向 Convex 部署的 /api/github/webhook 端点。

验证是否装好

运行 connectRepo 连接一个仓库后，调用 listRepos 应返回该仓库，再调用 adminHealth 确认表计数与队列健康状态正常。

常见排障

确保 GitHub PAT 有效且具有 `repo` 权限。检查 Webhook 配置是否正确指向 Convex 的 `/api/github/webhook` 且 secret 匹配。检查 Convex 部署状态和环境变量。查看日志中的错误并运行测试套件。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我已连接仓库中的所有 PR
帮我在 my-repo 仓库创建一个 issue，标题是 Bug 报告
在这条 issue 下面添加一条评论
检查一下 adminHealth，看同步状态是否正常

工具能力 9

connectRepo 写入

连接一个 GitHub 仓库进行镜像

listRepos 只读

列出所有镜像的仓库

listPRs 只读

列出某个仓库的拉取请求

listIssues 只读

列出某个仓库的问题

getActivity 只读

获取活动流相关数据

createIssue 写入

创建新的 GitHub Issue

createComment 写入

在 Issue 或 PR 上创建评论

mergePR 写入

合并一个拉取请求

展开其余 1 个工具

adminHealth 只读

获取系统健康状态和表计数

使用场景

快速浏览 GitHub Pull Request 列表

实时查看 GitHub Issue 更新

创建评论和合并 PR 的操作

监控仓库活动流

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

FasterGH 是一个 GitHub 镜像界面，使用 Convex 作为实时缓存/同步层，确保 GitHub 是数据源，Convex 提供低延迟读取模型。它通过 Webhook 实时更新，并在仓库接入时从 GitHub REST API 回填历史数据，提供了优化的读取界面，页面加载时不直接调用 GitHub API。支持通过乐观变更进行写入操作，如创建 Issue、评论、合并 PR。适合需要高频访问 GitHub 数据的开发者，尤其是那些希望减少 API 调用延迟和次数的人。