Summary
How other people actually wrote it, with the file and line to go read the rest.
Documentation shows the intended usage; this shows the usage that shipped. The language and repo filters are what keep a common pattern from returning noise, and every match arrives with its repository, path and line numbers, so the assistant can cite a real file rather than paraphrase one.
What it is
A server over the grep.app search index: one tool that runs a code search across public GitHub and returns matches grouped by repository.
What you get
- grep_query searches for a code pattern across the grep.app index
- Filters that narrow it — language, repo in owner/repo form, and path for a directory
- Results grouped by repository, each file carrying its path, branch, match count, line numbers and the code snippet
- A summary with the total number of results, the repositories found, and the top languages
- Both stdio and SSE transports, with --host and --port for the SSE mode
Requirements
Python 3.10 or higher; install with uv add grep-mcp or pip install grep-mcp, and launch with uvx. No account and no API key — it uses the public grep.app API, with a 30-second request timeout and rate limiting surfaced as a readable error rather than a hang.
Setup effort
One command — pip install grep-mcp