A Model Context Protocol (MCP) 서버는 grep.app API를 통해 GitHub 코드 검색 기능을 제공합니다. 이 서버는 특정 코드 패턴, 기능 및 구현을 위해 GitHub 저장소의 수백만을 검색하는 AI 조수가 가능합니다.

♨ 특징

• ** GitHub 코드 검색**: grep.app의 강력한 검색 인덱스를 사용하여 GitHub 저장소의 수백만을 검색 -** Advanced Advanced Filtering**: 프로그래밍 언어, 저장소 및 파일 경로로 필터 결과 -** - Smart Formatting**: 결과는 문법 강조, 저장소 그룹화 및 요약 통계를 포함합니다.
• ** **: 적절한 오류 처리 및 제한 속도와 동기화 구현
• ** 672️ 다중 전송 모드 ** : stdio 및 SSE (Server-Sent Events) 전송 지원
• ** 거짓 결과**: 파일 경로, 줄 번호, 코드 스니펫 및 저장소 정보 반환

요구사항

-Python: 3.10 이상

• ** 통화**:
• mcp - 모델 Context 프로토콜 프레임 워크
• starlette - SSE 운송 웹 프레임 워크
• uvicorn - ASGI 서버
• aiohttp - API 요청에 대한 HTTP 클라이언트 동기화

설치

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,