MCP Integration

vecgrep exposes a Model Context Protocol server for AI assistants.

Start the Server

vecgrep serve --mcp

The server communicates over stdio.

Tools

Tool	Purpose
vecgrep_init	Initialize or activate a project
vecgrep_search	Search indexed code
vecgrep_index	Index files
vecgrep_status	Inspect index and provider status
vecgrep_similar	Find similar code
vecgrep_delete	Remove a file from the index
vecgrep_clean	Optimize index data
vecgrep_reset	Clear the index
vecgrep_overview	Summarize codebase structure
vecgrep_batch_search	Run multiple searches
vecgrep_related_files	Find related files

Claude Code

Add vecgrep globally:

claude mcp add vecgrep -- vecgrep serve --mcp

Or add it for the current project:

claude mcp add --scope project vecgrep -- vecgrep serve --mcp

Manual Config

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

Project Activation

vecgrep_init defaults to global storage under ~/.vecgrep/projects. Set local=true only when you want a project-local .vecgrep/ directory.