Grep.app API を通じて GitHub コード検索機能を提供する Model Context Protocol (MCP) サーバー。 このサーバーでは、AIアシスタントが特定のコードパターン、関数、実装の何百万ものGitHubリポジトリから検索することができます。

OST の特徴

• ** GitHub コード検索**: grep.appの強力な検索インデックスを使用して、GitHubリポジトリの何百万人もの検索
• ** 高度なフィルタリング**:プログラミング言語、リポジトリ、ファイルパスによるフィルタ結果
• スマートフォーマット:結果には、構文の強調表示、リポジトリのグループ化、および概要の統計が含まれます -** ⚡ High Performance**: 適切なエラー処理とレート制限による非同期実装 -複数のトランスポートモード:stdioとSSE(サーバー・セント・イベント)の両方の輸送をサポート -リッチ結果:ファイルパス、行番号、コードスニペット、リポジトリ情報を返す

よくある質問

-Python: 3.10以上 -Dependencies:

• [mcp - モデルコンテキストプロトコルフレームワーク
• [starlette - SSE輸送用のWebフレームワーク
• [uvicorn - ASGIサーバ
• [aiohttp - API リクエストの HTTP クライアントを Async

❀ インストール

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,