grepai-mcp-claude

GrepAI MCP Integration with Claude Code

This skill covers integrating GrepAI with Claude Code using the Model Context Protocol (MCP).

When to Use This Skill

• Setting up GrepAI in Claude Code
• Enabling semantic search for AI coding assistant
• Configuring MCP server for Claude
• Troubleshooting Claude Code integration

What is MCP?

Model Context Protocol (MCP) allows AI assistants to use external tools. GrepAI provides an MCP server that gives Claude Code:

• Semantic code search
• Call graph analysis
• Index status monitoring

Prerequisites

1. GrepAI installed
2. Ollama running (or other embedding provider)
3. Project indexed (grepai watch)
4. Claude Code installed

Quick Setup

One command to add GrepAI to Claude Code:

claude mcp add grepai -- grepai mcp-serve

That's it! Claude Code can now use GrepAI tools.

Manual Configuration

If you prefer manual setup, add to Claude Code's MCP config:

Location

• macOS/Linux: ~/.claude/mcp.json
• Windows: %APPDATA%\Claude\mcp.json

Configuration

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

With Working Directory

If you want GrepAI to always use a specific project:

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

Verifying Installation

Check MCP Server

# Start MCP server manually to test
grepai mcp-serve

You should see:

GrepAI MCP Server started
Listening for requests...

In Claude Code

Ask Claude:

"Search the codebase for authentication code"

Claude should use the grepai_search tool.

Available Tools

Once connected, Claude Code has access to these tools:

Tool	Description	Parameters
grepai_search	Semantic code search	query (required), limit, compact
grepai_trace_callers	Find function callers	symbol (required), compact
grepai_trace_callees	Find function callees	symbol (required), compact
grepai_trace_graph	Build call graph	symbol (required), depth
grepai_index_status	Check index health	verbose (optional)