🔍 Repo Scout MCP Server

"Vibe Coder 和软件工程师的第一条规则：不要重复造轮子。在写一行代码之前，让 AI 先搜索现有的 GitHub 项目！"

一个高性能、免费的本机 Model Context Protocol (MCP) 服务器，让 AI 助手（Google Antigravity、Claude Desktop、Cursor、Claude Code）在您开始从零构建之前，先搜索 GitHub 上现有的开源项目、库和框架。

👤 作者与致谢

• 作者： Akash Kumar Jha

• 许可证： MIT License（免费且开源）

Related MCP server: GitBridge

🚀 为什么使用 Repo Scout MCP？

在进行 vibe coding 或构建软件时，开发人员常常会花费数小时为那些已经以久经考验的高质量开源项目形式存在的功能或完整应用编写代码。

Repo Scout MCP 将您的 AI 编码助手直接连接到 GitHub 的搜索与智能 API：

• 💡 节省数百小时： 在开始项目之前立即发现现有解决方案。

• 🆓 100% 免费且本地运行： 无需付费 API 订阅。通过 Node.js 在 stdio 上本地运行。

• ⚡ 高性能： 使用免费令牌将 GitHub 速率限制从 60 提升到 5,000 次请求/小时。

• 🛡️ 隐私与安全： 零硬编码密钥或跟踪。每个用户提供自己的环境变量。

🛠️ 包含的工具

📦 快速开始与安装

第 1 步：克隆仓库

git clone https://github.com/YOUR_USERNAME/repo-scout-mcp.git
cd repo-scout-mcp
npm install

第 2 步：获取免费的 GitHub 访问令牌（2 分钟）

1. 前往 GitHub Settings -> Tokens。

2. 点击 Generate new token $\rightarrow$ Generate new token (classic)。

3. 将其命名为 repo-scout-mcp。

4. 保持所有范围复选框未选中（公共数据搜索不需要任何权限）。

5. 点击 Generate token 并复制它（看起来像 ghp_xxxxxxxxxxxx）。

🔌 连接到您的 AI 助手

1. Google Antigravity

1. 打开 Antigravity $\rightarrow$ 点击代理面板右上角的 ... 菜单。

2. 前往 MCP Servers $\rightarrow$ Manage MCP Servers $\rightarrow$ View raw config（mcp_config.json）。

3. 在 "mcpServers" 内添加以下条目：

{
  "mcpServers": {
    "repo-scout": {
      "command": "node",
      "args": ["G:\\CODE\\repo-scout-mcp\\index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_personal_access_token_here"
      }
    }
  }
}

（注意：将 G:\\CODE\\repo-scout-mcp\\index.js 替换为您实际的完整文件路径，在 Windows 上使用双反斜杠）。

4. 保存 mcp_config.json 并刷新 MCP 服务器（或在聊天中输入 /mcp）。

2. Claude Desktop

添加到您的 claude_desktop_config.json：

• Windows： %APPDATA%\Claude\claude_desktop_config.json

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "repo-scout": {
      "command": "node",
      "args": ["/absolute/path/to/repo-scout-mcp/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_personal_access_token_here"
      }
    }
  }
}

3. Claude Code CLI

运行：

claude mcp add repo-scout node /absolute/path/to/repo-scout-mcp/index.js -e GITHUB_TOKEN=ghp_your_token_here

💬 可尝试的示例提示

连接后，只需向您的 AI 助手提问：

• 在开始项目之前：

  "我计划构建一个用于监控 Docker 容器的自托管仪表板。使用 repo-scout 检查是否已有优秀的开源项目。"

• 搜索库：

  "使用 repo-scout 搜索高星标的 TypeScript 金融技术指标包。"

• 评估仓库：

  "使用 repo-scout get_repo_details 查看 shadcn/ui 并总结其结构。"

📄 许可证

由 Akash Kumar Jha 创建。以 MIT License 发布。