Inkdex

MCP server for semantic search over markdown docs.

Tools

Related MCP server: Markdown RAG Documentation

Usage

Add to your MCP client configuration:

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

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