GitHub MCP Server

MCP сервер для поиска проектов на GitHub. Поиск репозиториев по задачам, технологиям, с фильтрацией по звёздам, языку и дате.

Возможности

• 🔍 Поиск репозиториев по ключевым словам и задачам
• ⭐ Фильтрация по звёздам — находит проекты с высоким рейтингом
• 💻 Поиск по языку — популярные проекты на определённом языке
• 📅 Поиск новых проектов — недавно созданные/обновлённые репозитории
• 🔥 Трендовые проекты — набирающие популярность
• 📄 Получение README — документация репозитория
• 📊 Подробная информация — статистика, темы, лицензии

Установка

Не требует внешних зависимостей — только стандартная библиотека Python.

cd github-mcp-server
python3 server.py

Интеграция с MCP клиентом

Добавьте в конфигурацию:

{
  "mcpServers": {
    "github": {
      "command": "python3",
      "args": ["/path/to/github-mcp-server/server.py"]
    }
  }
}

С GitHub токеном (рекомендуется)

Для увеличения лимитов создайте токен на https://github.com/settings/tokens и добавьте в server.py:

GITHUB_TOKEN = "ghp_ваш_токен"

Инструменты

1. search_repos — Поиск репозиториев

Параметры:

• query (string) — Поисковый запрос
• min_stars (int) — Минимум звёзд
• language (string) — Язык программирования
• license (string) — Лицензия (MIT, Apache-2.0, etc.)
• sort (string) — Сортировка: stars, forks, updated
• per_page (int) — Количество (1-100)

Примеры:

// Поиск ML проектов с 1000+ звёзд
{"query": "machine learning", "min_stars": 1000}

// Python веб-фреймворки
{"query": "web framework", "language": "Python", "min_stars": 500}

// Open source с MIT лицензией
{"query": "database", "license": "MIT", "min_stars": 100}

2. get_repo_info — Информация о репозитории

Параметры:

• repo (string) — owner/repo

Пример:

{"repo": "torvalds/linux"}

3. get_trending — Трендовые репозитории

Параметры:

• language (string, optional) — Язык
• since (string) — Период: daily, weekly, monthly
• limit (int) — Количество

Пример:

{"language": "Rust", "since": "weekly", "limit": 10}

4. search_by_language — Поиск по языку

Параметры:

• language (string) — Язык
• min_stars (int) — Минимум звёзд (по умолчанию 1000)
• per_page (int) — Количество

Пример:

{"language": "Go", "min_stars": 5000, "per_page": 10}

5. search_recent — Новые проекты

Параметры:

• query (string) — Поисковый запрос
• days (int) — За сколько дней
• min_stars (int) — Минимум звёзд
• per_page (int) — Количество

Пример:

{"query": "LLM", "days": 30, "min_stars": 50}

6. get_repo_readme — README репозитория

Параметры:

• repo (string) — owner/repo

Пример:

{"repo": "microsoft/vscode"}

Ограничения

• ⏱️ 6 секунд между запросами (rate limiting)
• 📊 Без токена: 10 запросов/мин
• 🔑 С токеном: 30 запросов/мин
• 📄 Максимум 100 результатов за запрос

Лицензия

MIT