Kodit: A Code Indexing MCP Server

by helixml

119 stars
402 downloads
Not rated
GitHub Website

About

👩‍💻 MCP server to index external repositories

Details

Author
helixml
GitHub stars
119
Downloads
402
Categories
Developer Tools, AI

- 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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Kodit: A Code Indexing MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

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 |

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.