grep_queryLABSCO 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
USE CASES
01
Finding out how a library is really used
Search for the call and read the snippets from repositories that depend on it.
02
Checking a pattern inside one specific project
Restrict the search to owner/repo and get only that repository's matches.
03
Looking for an idiom in one language
Filter by language so a Python question does not come back full of JavaScript.
04
Seeing which projects use an approach
The summary reports the repositories found and the top languages, before you read a single snippet.
05
Narrowing to a part of a codebase
Add a path filter so results come only from the directory you care about.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- uvx on PATH
- Python 3.10 or later
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"grep-mcp": {
"command": "uvx",
"args": [
"grep-mcp"
]
}
}
}pip
TERMINAL
pip install grep-mcp
