GREB MCP Server
Semantic code search for AI agents. Search your codebase using natural language queries.
Features
Natural Language Search - Describe what you're looking for in plain English
High-Precision Results - Smart ranking returns the most relevant code first
Works with Any MCP Client - Claude Desktop, Cursor, Windsurf, Cline, Kiro, and more
No Indexing Required - Search any codebase instantly without setup
Fast - Results in under 5 seconds even for large repositories
Installation
Install Greb globally using pip or npm:
Python:
Node.js:
Get Your API Key
Go to Dashboard → API Keys
Click Create API Key
Copy the key (starts with
grb_)
Configuration
Add to your MCP client config (Cursor, Windsurf, Claude Desktop, Kiro, etc.):
Python installation:
Node.js installation:
Claude Code Setup
Mac/Linux (Python):
Windows PowerShell (Python):
Mac/Linux (Node.js):
Windows PowerShell (Node.js):
Tool: code_search
Search code using natural language queries powered by AI.
Parameters
Parameter | Type | Required | Description |
| string | Yes | Natural language search query |
| object | Yes | Search configuration |
| string[] | Yes | High-level semantic terms (e.g., "authentication", "database") |
| string[] | No | Literal code patterns to grep for |
| string[] | Yes | File extensions to search (e.g.,
) |
| string | Yes | Brief description of what you're looking for |
| string | Yes | Full absolute path to directory to search |
Example
Response
Returns ranked code snippets with:
File paths
Line numbers
Relevance scores
Code content
Reasoning for each match
Usage Examples
Ask your AI assistant to search code naturally:
Links
License
This project is licensed under the MIT License — see the LICENSE file for details.