Kodit: A Code Indexing MCP Server
About
👩💻 MCP server to index external repositories
Details
- License
- Apache-2.0
Explore
- 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).
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Kodit: A Code Indexing MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
For production use, deploy with PostgreSQL (VectorChord) for scalable vector search and a dedicated LLM provider for enrichments.
Set the API_KEYS environment variable to a comma-separated list of keys. Write endpoints (creating repositories, triggering syncs) require a valid key in the Authorization: Bearer <key> header. Search endpoints are open by default.
Configuration is done through environment variables. You can also use a .env file:
kodit serve --env-file .env
[email protected]:username/repo.git
```
kodit_repositories
List all indexed repositories
kodit_semantic_search
Semantic similarity search across code
kodit_keyword_search
BM25 keyword search
kodit_visual_search
Search document page images
kodit_grep
Regex pattern matching
kodit_ls
List files by glob pattern
kodit_read_resource
Read file content by URI
kodit_architecture_docs
Architecture documentation for a repo
kodit_api_docs
Public API documentation
kodit_database_schema
Database schema documentation
kodit_cookbook
Usage examples and patterns
kodit_commit_description
Commit description
kodit_wiki
Wiki table of contents
kodit_wiki_page
Read a specific wiki page
kodit_version
Server version
Kodit exposes these tools to connected AI assistants:
| Tool | Description |
|------|-------------|
| kodit_repositories | List all indexed repositories |
| kodit_semantic_search | Semantic similarity search across code |
| kodit_keyword_search | BM25 keyword search |
| kodit_visual_search | Search document page images |
| kodit_grep | Regex pattern matching |
| kodit_ls | List files by glob pattern |
| kodit_read_resource | Read file content by URI |
| kodit_architecture_docs | Architecture documentation for a repo |
| kodit_api_docs | Public API documentation |
| kodit_database_schema | Database schema documentation |
| kodit_cookbook | Usage examples and patterns |
| kodit_commit_description | Commit description |
| kodit_wiki | Wiki table of contents |
| kodit_wiki_page | Read a specific wiki page |
| kodit_version | Server version |
The enrichment tools (architecture_docs, api_docs, database_schema, cookbook, wiki, commit_description) require an LLM provider to be configured. See Enrichment Providers under Configuration Reference.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"kodit: a code indexing mcp server": {
"kodit": {
"command": "docker",
"args": [
"run",
"-p",
"8080:8080",
"registry.helix.ml/helix/kodit:latest"
]
}
}
}
}McpServers
{
"kodit": {
"command": "docker",
"args": [
"run",
"-p",
"8080:8080",
"registry.helix.ml/helix/kodit:latest"
]
}
}Server
| Variable | Default | Description |
|----------|---------|-------------|
| HOST | 0.0.0.0 | Listen address |
| PORT | 8080 | Listen port |
| DATA_DIR | ~/.kodit | Data directory for models, clones, and database |
| DB_URL | (empty) | PostgreSQL connection string (uses SQLite if empty) |
| LOG_LEVEL | INFO | Logging verbosity: DEBUG, INFO, WARN, ERROR |
| LOG_FORMAT | pretty | Log format: pretty or json |
| API_KEYS | (empty) | Comma-separated API keys for write endpoints |
| WORKER_COUNT | 1 | Number of background workers |
| SEARCH_LIMIT | 10 | Default search result limit |
| DISABLE_TELEMETRY | false | Disable anonymous usage telemetry |
| HTTP_CACHE_DIR | (empty) | Directory for caching HTTP POST responses to disk; avoids repeated API calls during development |
| REPORTING_LOG_TIME_INTERVAL | 5 | Progress reporting interval in seconds |
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
