zoekt-mcp

An MCP server that exposes Zoekt code search capabilities to AI agents. Enables semantic code search across indexed repositories through the Model Context Protocol.

Quick Start

# Run with npx (no install required)
npx zoekt-mcp --url http://localhost:6070

# Or install globally
npm install -g zoekt-mcp
zoekt-mcp --url http://localhost:6070

Features

• Code search — Full Zoekt query syntax support for powerful code search
• Repository listing — List all indexed repositories
• File content retrieval — Fetch file contents directly from indexed repos
• Flexible transport — Supports both HTTP and stdio transport modes
• Claude Desktop integration — Ready-to-use configuration for Claude Desktop

Tools

The server exposes three MCP tools:

• search — Search code with Zoekt query syntax
• list_repos — List indexed repositories
• file_content — Get file contents from a repository

Claude Desktop Configuration

{
  "mcpServers": {
    "zoekt": {
      "command": "npx",
      "args": ["zoekt-mcp", "--url", "http://localhost:6070", "--transport", "stdio"]
    }
  }
}