Inkdex

0 starsApache-2.0Community

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Enables semantic search over local markdown documentation by indexing files and ranking results using vector similarity and BM25 fusion.

README.md

Inkdex

![npm](https://www.npmjs.com/package/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... ``