grep.app Code Search

AModel Context Protocol (MCP)server that provides GitHub code search capabilities through thegrep.appAPI. This server enables AI assistants to search through millions of GitHub repositories for specific code patterns, functions, and implementations.

# 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

{ "mcpServers": { "grep-mcp": { "command": "uvx", "args": ["grep-mcp"] } } }

# 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

- --transport: Choose betweenstdio(default) orsse
- --host: Host to bind to for SSE mode (default:0.0.0.0)
- --port: Port to listen on for SSE mode (default:8080)

Search GitHub repositories for specific code patterns.

- 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/")

# 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")

{ "query": "your search query", "summary": { "total_results": 12345, "results_shown": 10, "repositories_found": 4, "top_languages": [ { "language": "Python", "count": 8500 }, { "language": "JavaScript", "count": 2000 } ], "top_repositories": [{ "repository": "owner/repo", "count": 150 }] }, "results_by_repository": [ { "repository": "owner/repo", "matches_count": 89, "files": [ { "file_path": "src/main.py", "branch": "main", "total_matches": 5, "line_numbers": [10, 25, 30], "language": "python", "code_snippet": "

- FastMCP Framework: Built on the FastMCP framework for easy MCP server development
- Async HTTP Client: Uses aiohttp for non-blocking API requests
- Response Formatting: Intelligent parsing and formatting of grep.app responses
- Error Handling: Comprehensive error handling for API failures, timeouts, and rate limits
- Transport Flexibility: Supports both stdio and web-based SSE transport modes
The server handles various error conditions gracefully:
- Rate Limiting: Automatic detection and user-friendly error messages

- Network Timeouts: 30-second timeout with proper error reporting

- API Failures: Graceful handling of grep.app API issues

- Invalid Parameters: Comprehensive parameter validation with helpful error messages

- MCP server initialization
- Tool parameter validation
- Error handling scenarios
- Response formatting
- Platform compatibility
- Fork the repository
- Create a feature branch:git checkout -b feature/amazing-feature
- Make your changes with tests
- Run the test suite:uv run pytest
- Format code:uv run black . && uv run isort .
- Commit changes:git commit -m 'Add amazing feature'
- Push to branch:git push origin feature/amazing-feature`
- Open a Pull Request

This project is licensed under the MIT License - see theLICENSEfile for details.

- grep.appfor providing the excellent GitHub search API
- MCP (Model Context Protocol)for the protocol specification
- FastMCPfor the server framework

- Issues:GitHub Issues
- Repository:GitHub Repository

A modular MCP server for code analysis, supporting file operations, code search, and structure analysis.