Inkdex

MCP server for semantic search over markdown docs.

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

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