Markdown语义搜索服务

Inkdex是一个用于对Markdown文档进行语义搜索的MCP服务器,支持基于向量相似性和BM25全文匹配的混合搜索技术。

  • by antonlunden
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 kandobyte/inkdex

使用说明

Inkdex

MCP服务器,用于对markdown文档进行语义搜索。

工具

工具 说明
search_docs 搜索索引文档。返回按相关性排序的匹配块。

用法

添加到MCP客户端配置中:

{
  "mcpServers": {
    "inkdex": {
      "command": "npx",
      "args": [
        "-y",
        "inkdex"
      ],
      "env": {
        "DOCS_PATH": "/path/to/your/docs"
      }
    }
  }
}
变量 必填 描述
DOCS_PATH 是 包含要索引的markdown文件的目录路径

运作原理

Markdown文件按标题结构和段落边界分成块。块在本地嵌入使用 all-MiniLM-L6-v2 并存储在SQLite中。

搜索使用向量相似度和BM25全文匹配对结果进行排名,通过以下方式组合 Reciprocal Rank Fusion:RRF(相互排名融合).

结果包括来源、上下文和文本:

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