Сервер Model Context Protocol (MCP), который предоставляет возможности поиска кода GitHub через API grep.app. Этот сервер позволяет помощникам ИИ искать через миллионы репозиториев GitHub конкретные шаблоны кода, функции и реализации.

Feature Особенности

• ** * * * GitHub Code Search ** Поиск по миллионам репозиториев GitHub с помощью мощного поискового индекса grep.app *** Расширенная фильтрация**: результаты фильтрации по языку программирования, репозиторию и пути файла *** Умное форматирование**: результаты включают выделение синтаксиса, группировку репозиториев и сводную статистику Высокая производительность: реализация Async с надлежащей обработкой ошибок и ограничением скорости
• ** s️ Несколько видов транспорта**: поддерживает как стрио, так и SSE (Server-Sent Events) ** Богатые результаты**: возвращает пути файлов, номера строк, фрагменты кода и информацию репозитория

Требования

• Питон: 3.10 или выше
• ** Зависимости**:
• mcp - Модель контекстного протокола
• starlette - Веб-фреймворк для транспорта SSE
• uvicorn - сервер ASGI aiohttp - Async HTTP-клиент для запросов API

###Установка

Использование uv (рекомендуется)

Использование Pip

Использование

Grep MCP Server

A Model Context Protocol (MCP) server that provides GitHub code search capabilities through the grep.app API. This server enables AI assistants to search through millions of GitHub repositories for specific code patterns, functions, and implementations.

🚀 Features

• 🔍 GitHub Code Search: Search across millions of GitHub repositories using grep.app’s powerful search index
• 🎯 Advanced Filtering: Filter results by programming language, repository, and file path
• 📊 Smart Formatting: Results include syntax highlighting, repository grouping, and summary statistics
• ⚡ High Performance: Async implementation with proper error handling and rate limiting
• 🛠️ Multiple Transport Modes: Supports both stdio and SSE (Server-Sent Events) transport
• 📝 Rich Results: Returns file paths, line numbers, code snippets, and repository information

📋 Requirements

• Python: 3.10 or higher
• Dependencies:
  • mcp - Model Context Protocol framework
  • starlette - Web framework for SSE transport
  • uvicorn - ASGI server
  • aiohttp - Async HTTP client for API requests

🔧 Installation

Using uv (Recommended)

# Install directly from PyPI
uv add grep-mcp

# Or install from source
git clone https://github.com/galperetz/grep-mcp.git
cd grep-mcp
uv sync

Using pip

pip install grep-mcp

🎯 Usage

As MCP Server (Recommended)

Add to your MCP client configuration:

{
  "mcpServers": {
    "grep-mcp": {
      "command": "uvx",
      "args": ["grep-mcp"]
    }
  }
}

Direct Execution

# Run with stdio transport (default)
python -m grep_mcp

# Run with SSE transport
python -m grep_mcp --transport sse --host 0.0.0.0 --port 8080

Command Line Arguments

• --transport: Choose between stdio (default) or sse
• --host: Host to bind to for SSE mode (default: 0.0.0.0)
• --port: Port to listen on for SSE mode (default: 8080)

🔧 Available Tools

grep_query

Search GitHub repositories for specific code patterns.

Parameters:

• query (required): The search query string
• language (optional): Programming language filter (e.g., “Python”, “JavaScript”)
• repo (optional): Repository filter in format “owner/repo” (e.g., “fastapi/fastapi”)
• path (optional): Path filter for specific directories (e.g., “src/”)

Examples:

# Basic search
grep_query("async def main")

# Search Python files only
grep_query("FastAPI", language="Python")

# Search specific repository
grep_query("class Config", repo="fastapi/fastapi")

# Search in specific directory
grep_query("import", path="src/")

# Combined filters
grep_query("async def", language="Python", repo="fastapi/fastapi")

📊 Response Format

The tool returns structured JSON with:

{
  "query": "your search query",
  "summary": {
    "total_results": 12345,
    "results_shown": 10,
    "repositories_found": 4,