grepai-mcp-cursor

This skill covers integrating GrepAI with Cursor IDE using the Model Context Protocol (MCP).

When to Use This Skill

• Setting up GrepAI in Cursor

• Enabling semantic search for Cursor AI

• Configuring MCP for Cursor

• Troubleshooting Cursor integration

What is Cursor?

Cursor is an AI-powered IDE that supports MCP for external tools. GrepAI integration gives Cursor's AI:

• Semantic code search beyond simple text matching

• Call graph analysis for understanding dependencies

• Index-based code navigation

Prerequisites

• GrepAI installed

• Ollama running (or other embedding provider)

• Project indexed (grepai watch)

• Cursor IDE installed

Configuration

Step 1: Create MCP Config File

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"]
    }
  }
}

Step 2: Restart Cursor

Close and reopen Cursor for the config to take effect.

Step 3: Verify

Ask Cursor's AI:

"Search the codebase for authentication"

Cursor should use the grepai_search tool.

Global Configuration

For GrepAI in all Cursor projects, use global config:

Location

• macOS: ~/.cursor/mcp.json

• Linux: ~/.cursor/mcp.json

• Windows: %APPDATA%\Cursor\mcp.json

Content

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"]
    }
  }
}

Per-Project Configuration

For project-specific settings:

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"],
      "cwd": "/absolute/path/to/project"
    }
  }
}

Available Tools

Once configured, Cursor has access to:

| grepai_search | Semantic code search

| grepai_trace_callers | Find function callers

| grepai_trace_callees | Find function callees

| grepai_trace_graph | Build call graphs

| grepai_index_status | Check index health

Usage Examples

Finding Code

Ask Cursor:

"Find code that handles user login"

Cursor uses grepai_search to find semantically related code.

Understanding Dependencies

Ask Cursor:

"What functions call validateToken?"

Cursor uses grepai_trace_callers to show all callers.

Code Navigation

Ask Cursor:

"Show me the call graph for processPayment"

Cursor uses grepai_trace_graph to display dependencies.

Cursor Settings Integration

Enable MCP in Settings

• Open Cursor Settings (Cmd+, / Ctrl+,)

• Search for "MCP"

• Ensure MCP is enabled

Verify MCP Status

• Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)

• Search "MCP"

• Check connected servers

Windsurf Configuration

Windsurf uses the same MCP format as Cursor:

Location

Create .windsurf/mcp.json:

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"]
    }
  }
}

Multiple Projects Setup

Option 1: Separate Configs

Each project has its own .cursor/mcp.json with appropriate cwd.

Option 2: Workspaces

# Create workspace
grepai workspace create dev
grepai workspace add dev /path/to/project1
grepai workspace add dev /path/to/project2

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve", "--workspace", "dev"]
    }
  }
}

Environment Variables

If GrepAI uses environment variables (like API keys):

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Better: Set environment variables in your shell profile instead.

Troubleshooting

MCP Not Recognized

❌ Problem: Cursor doesn't see GrepAI tools

✅ Solutions:

• Check file location: .cursor/mcp.json in project root

• Verify JSON syntax (no trailing commas)

• Restart Cursor completely

• Check grepai is in PATH

Search Returns Nothing

❌ Problem: Empty search results

✅ Solutions:

• Ensure index exists: grepai status

• Run grepai watch first

• Verify working directory

Connection Errors

❌ Problem: MCP connection failed

✅ Solutions:

• Test manually: grepai mcp-serve

• Check Ollama: curl http://localhost:11434/api/tags

• Look at Cursor's developer console for errors

Wrong Results

❌ Problem: Results from wrong project

✅ Solutions:

• Set explicit cwd in config

• Check you opened the right folder in Cursor

• Use grepai_index_status to verify

Performance Tips

• Background daemon: Keep grepai watch --background running

• Use compact mode: MCP tools use compact by default

• Limit results: AI will request appropriate limits

• Index regularly: Especially after git pull

Comparison: Cursor vs Claude Code

| Config location | .cursor/mcp.json | ~/.claude/mcp.json

| Setup command | Manual JSON | claude mcp add

| Project scope | Per-project or global | Global

| IDE integration | Native | Terminal

Best Practices

• Version control: Add .cursor/mcp.json to git (without secrets)

• Team setup: Document MCP config in README

• Keep index fresh: Run watch daemon

• Test locally: Verify grepai mcp-serve works first

• Use workspaces: For multi-project setups

Removing Integration

Delete .cursor/mcp.json and restart Cursor.

Or remove just GrepAI:

{
  "mcpServers": {
    // Remove grepai entry
  }
}

Output Format

Successful Cursor setup:

✅ GrepAI MCP Integration for Cursor

   Config: .cursor/mcp.json
   Server: grepai mcp-serve
   Status: Ready

   Available tools:
   - grepai_search
   - grepai_trace_callers
   - grepai_trace_callees
   - grepai_trace_graph
   - grepai_index_status

   Cursor AI can now search your code semantically!

   Test: Ask Cursor "search for authentication code"