Grep MCP Server - non official MCP for grep.app
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"grep-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Grep MCP Server A **Model Context Protocol (MCP)** server that provides GitHub code search capabilities through the [grep.app](https://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) ```bash # 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 ```bash pip install grep-mcp ``` ## 🎯 Usage ### As MCP Server (Recommended) Add to your MCP client configuration: ```json { "mcpServers": { "grep-mcp": { "command": "uvx", "args": ["grep-mcp"] } } } ``` ### Direct Execution ```bash # 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: `808…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.