Kodit: A Code Indexing MCP Server

What is Kodit?

Kodit is a code and document intelligence server that indexes Git repositories and provides search through MCP and REST APIs. It splits source files into searchable snippets and serves relevant examples to any MCP‑compatible AI assistant.

How to use Kodit?

Run Kodit with Docker (docker run -p 8080:8080 registry.helix.ml/helix/kodit:latest) or a pre‑built binary (./kodit serve). Add the MCP endpoint (http://localhost:8080/mcp) to your assistant’s configuration. Use the REST API at /api/v1/ for programmatic indexing and search.

Key features of Kodit

• Multiple search strategies: BM25 keyword, semantic vector, regex grep, and visual document search.
• MCP server compatible with Claude Code, Cursor, Cline, and Kilo Code.
• REST API for programmatic access to repositories, search, and indexing status.
• Optional AI enrichments: architecture docs, API docs, database schema, cookbook examples, commit summaries.
• Document intelligence: index PDFs, Word, PowerPoint, and spreadsheets with visual search.
• No external dependencies required (built‑in embedding model and SQLite storage).

Use cases of Kodit

• Help an AI assistant find relevant code examples before writing new features.
• Search across both source code and business documentation from a single interface.
• Automatically generate architecture and API documentation for existing repositories.
• Perform regex‑based searches across large codebases for refactoring or auditing.
• Embed code search capabilities directly into a Go application via the library.

FAQ from Kodit

What assistants can connect to Kodit?

Kodit works with any MCP‑compatible assistant, including Claude Code, Cursor, Cline, and Kilo Code.

What search methods does Kodit offer?

Kodit provides BM25 keyword search, semantic vector search, regex grep, and visual search for document page images.

Does Kodit require external API keys or LLM providers?

Basic operation (indexing and search) requires no API keys. Optional AI enrichments need an LLM provider (e.g., OpenAI or Anthropic).

How are repositories indexed?

Add a repository via the REST API (POST /api/v1/repositories). Kodit clones the repository, splits files into snippets, and indexes them. You can monitor progress with the status endpoint.

How is authentication handled?

Set the API_KEYS environment variable to a comma‑separated list. Write endpoints require a valid key in the Authorization: Bearer header; search endpoints are open by default.