Provides containerization capabilities for the MCP server, allowing deployment in isolated environments with configurable network settings and environment variables.
Runs the MCP server and is required for execution, with version 3.10+ specified as a prerequisite.
Used for code style checking and formatting during development of the MCP server.
Zoekt MCP Server
A Model Context Protocol (MCP) server that provides code search capabilities powered by Zoekt, the indexed code search engine used by Sourcegraph.
Table of Contents
Related MCP server: Code Context MCP Server
Overview
This MCP server integrates with Zoekt, a text search engine optimized for code repositories. Zoekt provides trigram-based indexing for searches across large codebases, making it suitable for AI assistants that need to find and understand code patterns.
Features
Code Search: Search across codebases using Zoekt's trigram indexing
Advanced Query Language: Support for regex patterns, file filters, language filters, and boolean operators
Repository Discovery: Find repositories by name and explore their structure
Content Fetching: Browse repository files and directories
AI Integration: Designed for LLM integration with guided search prompts
Prerequisites
Zoekt Instance: You need access to a running Zoekt search server. See the Zoekt documentation for setup instructions.
Python 3.10+: Required for running the MCP server
UV (optional): Modern Python package manager for easier dependency management
Installation
Using UV (recommended)
Using pip
Using Docker
Configuration
Required Environment Variables
ZOEKT_API_URL: URL of your Zoekt search instance
Optional Environment Variables
MCP_SSE_PORT: SSE server port (default: 8000)MCP_STREAMABLE_HTTP_PORT: HTTP server port (default: 8080)
Usage with AI Tools
Cursor
After running the MCP server, add the following to your .cursor/mcp.json file:
MCP Tools
This server provides three powerful tools for AI assistants:
🔍 search
Search across indexed codebases using Zoekt's advanced query syntax with support for regex, language filters, and boolean operators.
📖 search_prompt_guide
Generate a context-aware guide for constructing effective search queries based on your specific objective.
📂 fetch_content
Retrieve file contents or explore directory structures from indexed repositories.