Inkdex

RAG for your markdown docs, exposed over MCP. Local embeddings, zero config.

Tools

| Tool | Description | |------|-------------| | search_docs | Search indexed documentation. Returns matching chunks ranked by relevance. |

Usage

Add to your MCP client configuration:

{
  "mcpServers": {
    "inkdex": {
      "command": "npx",
      "args": [
        "-y",
        "inkdex"
      ],
      "env": {
        "DOCS_PATH": "/path/to/your/docs"
      }
    }
  }
}

| Variable | Required | Description | |----------|----------|-------------| | DOCS_PATH | Yes | Path to the directory containing markdown files to index |

Runs over stdio. For remote access, use an MCP gateway (MCPBox).

How it works

Markdown files are split into chunks by heading structure and paragraph boundaries. Chunks are embedded locally using all-MiniLM-L6-v2 and stored in SQLite.

Search ranks results using both vector similarity and BM25 full-text matching, combined via Reciprocal Rank Fusion.

Results include the source, context, and text:

[mira/authentication.md]
<context>
Authentication > Token Expiration and Refresh
</context>
The refresh token expires...