🗄️ LanceDB MCP 服务器，适用于 LLM

一个模型上下文协议 (MCP) 服务器，使 LLM 能够通过 LanceDB 中的 Agentic RAG 和混合搜索直接与它们在磁盘上的文档进行交互。向 LLM 询问关于整个数据集或特定文档的问题。

✨ 特性

• 🔍 LanceDB 驱动的无服务器向量索引和文档摘要目录。
• 📊 有效利用 LLM tokens。LLM 本身会在需要时查找它需要的内容。
• 📈 安全性。索引存储在本地，因此在使用本地 LLM 时不会将数据传输到云端。

🚀 快速开始

要开始使用，请创建一个本地目录来存储索引，并将此配置添加到您的 Claude Desktop 配置文件中：

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lancedb": {
      "command": "npx",
      "args": [
        "lance-mcp",
        "PATH_TO_LOCAL_INDEX_DIR"
      ]
    }
  }
}

前提条件

• Node.js 18+
• npx
• MCP 客户端（例如 Claude Desktop App）
• 已安装摘要和嵌入模型（请参阅 config.ts - 默认情况下我们使用 Ollama 模型）
  • ollama pull snowflake-arctic-embed2
  • ollama pull llama3.1:8b

演示

<img src="https://github.com/user-attachments/assets/90bfdea9-9edd-4cf6-bb04-94c9c84e4825" width="50%">

本地开发模式：

{
  "mcpServers": {
    "lancedb": {
      "command": "node",
      "args": [
        "PATH_TO_LANCE_MCP/dist/index.js",
        "PATH_TO_LOCAL_INDEX_DIR"
      ]
    }
  }
}

使用 npm run build 构建项目。

使用 npx @modelcontextprotocol/inspector dist/index.js PATH_TO_LOCAL_INDEX_DIR 运行 MCP 工具检查器。

种子数据

种子脚本在 LanceDB 中创建两个表 - 一个用于文档摘要的目录，另一个用于向量化文档的块。 要运行种子脚本，请使用以下命令：

npm run seed -- --dbpath <PATH_TO_LOCAL_INDEX_DIR> --filesdir <PATH_TO_DOCS>

您可以使用来自 docs/ 目录的示例数据。 随意调整 config.ts 文件中的默认摘要和嵌入模型。 如果您需要重新创建索引，只需使用 --overwrite 选项重新运行种子脚本。

目录

• 文档摘要
• 元数据

块

• 向量化文档块
• 元数据

🎯 示例提示

尝试使用 Claude 的这些提示来探索功能：

"我们目录里有哪些文档？"
"为什么美国的医疗保健系统如此糟糕？"

📝 可用工具

服务器提供以下工具来与索引进行交互：

目录工具

• catalog_search: 在目录中搜索相关文档

块工具

• chunks_search: 根据目录中的特定文档查找相关块
• all_chunks_search: 从所有已知文档中查找相关块

📜 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。