Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GREB-MCPfind authentication middleware in my project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
pip install cheetah-grebNode.js:
npm install -g cheetah-grebGet 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:
{
"mcpServers": {
"greb-mcp": {
"command": "greb-mcp",
"env": {
"GREB_API_KEY": "grb_your_api_key_here"
}
}
}
}Node.js installation:
{
"mcpServers": {
"greb-mcp": {
"command": "greb-mcp-js",
"env": {
"GREB_API_KEY": "grb_your_api_key_here"
}
}
}
}Claude Code Setup
Mac/Linux (Python):
claude mcp add --transport stdio greb-mcp --env GREB_API_KEY=grb_your_api_key_here -- greb-mcpWindows PowerShell (Python):
claude mcp add greb-mcp greb-mcp --transport stdio --env "GREB_API_KEY=grb_your_api_key_here"Mac/Linux (Node.js):
claude mcp add --transport stdio greb-mcp --env GREB_API_KEY=grb_your_api_key_here -- greb-mcp-jsWindows PowerShell (Node.js):
claude mcp add greb-mcp greb-mcp-js --transport stdio --env "GREB_API_KEY=grb_your_api_key_here"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
{
"query": "find authentication middleware",
"keywords": {
"primary_terms": ["authentication", "middleware", "jwt"],
"code_patterns": ["authenticate(", "isAuthenticated"],
"file_patterns": ["*.js", "*.ts"],
"intent": "find auth middleware implementation"
},
"directory": "/Users/dev/my-project"
}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:
"Use greb mcp to find authentication middleware"
"Use greb mcp to find all API endpoints"
"Use greb mcp to look for database connection setup"
"Use greb mcp to find where user validation happens"
"Use greb mcp to search for error handling patterns"Links
License
This project is licensed under the MIT License — see the LICENSE file for details.