🔍 Repo Scout MCP Server

"Главное правило для Vibe-кодеров и инженеров-программистов: не изобретайте велосипед. Позвольте ИИ изучить существующие проекты на GitHub, прежде чем писать хоть одну строку кода!"

Высокопроизводительный бесплатный локальный Model Context Protocol (MCP) сервер, который даёт ИИ-ассистентам (Google Antigravity, Claude Desktop, Cursor, Claude Code) возможность искать существующие open-source проекты, библиотеки и фреймворки на GitHub до того, как вы начнёте писать код с нуля.

👤 Автор и благодарности

• Автор: Akash Kumar Jha

• Лицензия: MIT License (бесплатно и с открытым исходным кодом)

Related MCP server: GitBridge

🚀 Зачем использовать Repo Scout MCP?

При вайб-кодинге или разработке ПО разработчики часто тратят часы на написание кода для функций или целых приложений, которые уже существуют как проверенные в бою высококачественные open-source проекты.

Repo Scout MCP подключает вашего ИИ-ассистента напрямую к поисковым и интеллектуальным API GitHub:

• 💡 Экономия сотен часов: мгновенно находите существующие решения до начала проекта.

• 🆓 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 Access Token (2 минуты)

1. Перейдите в GitHub Settings -> Tokens.

2. Нажмите Generate new token $\rightarrow$ Generate new token (classic).

3. Назовите его repo-scout-mcp.

4. Оставьте все флажки областей видимости снятыми (поиск публичных данных не требует разрешений).

5. Нажмите Generate token и скопируйте его (выглядит как ghp_xxxxxxxxxxxx).

🔌 Подключение к вашему ИИ-ассистенту

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

💬 Примеры промптов для проверки

После подключения просто задайте вашему ИИ-ассистенту:

• Перед началом проекта:

  "Я планирую создать самохостинговую панель мониторинга для контейнеров Docker. Используй repo-scout, чтобы проверить, существует ли уже отличный open-source проект."

• Поиск библиотек:

  "Используй repo-scout для поиска высокорейтинговых TypeScript-пакетов финансовых технических индикаторов."

• Оценка репозитория:

  "Используй repo-scout get_repo_details для shadcn/ui, чтобы обобщить его структуру."

📄 Лицензия

Создано Akash Kumar Jha. Выпущено под MIT License.