使用说明

项目简介

mcp-server-lancedb 是一个实现了 Model Context Protocol (MCP) 的服务器，它使用 LanceDB 向量数据库作为后端，为大型语言模型 (LLM) 应用提供记忆存储和检索功能。通过此服务器，LLM 可以利用 'add-memory' 工具存储文本信息，并使用 'search-memories' 工具根据语义相似性检索相关记忆，从而扩展 LLM 的上下文理解和应用能力。

主要功能点

记忆存储: 使用 'add-memory' 工具将文本内容存储到 LanceDB 向量数据库中，形成 LLM 的长期记忆。
语义搜索: 通过 'search-memories' 工具，LLM 可以根据输入的查询语句，在记忆库中进行语义搜索，找到相关的记忆片段。
MCP 工具: 服务器实现了 'add-memory' 和 'search-memories' 两个 MCP 工具，方便 LLM 客户端调用，实现与记忆库的交互。

安装步骤

克隆仓库

git clone https://github.com/kyryl-opens-ml/mcp-server-lancedb
cd mcp-server-lancedb

安装依赖 确保你的环境中安装了 'uv' 包管理器 (参考仓库 README.md)。在项目根目录下运行：
```
uv sync
```
或者，如果你使用 'pip'，可以安装 'requirements.txt' 中的依赖：
```
pip install -r requirements.txt
```

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令和参数才能连接。以下是使用 'uv' 运行 'mcp-server-lancedb' 的配置示例 (JSON 格式)：

{
  "lancedb_server": {  //  服务器名称，可以自定义，用于在客户端中标识
    "command": "uv",   //  启动服务器的命令，这里假设使用 uv 运行
    "args": [      //  传递给命令的参数列表
      "run",      //  uv 的 run 命令，用于运行 Python 包
      "mcp-lance-db" //  要运行的 Python 包名称，对应 mcp-lance-db
    ]
  }
}

将以上 JSON 配置添加到你的 MCP 客户端配置文件中 (例如 Claude Desktop 的 'claude_desktop_config.json')。
确保你的 MCP 客户端能够找到 'uv' 命令。如果 'uv' 不在系统 PATH 中，你需要提供 'uv' 的完整路径。

基本使用方法

启动服务器: 配置完成后，当 MCP 客户端启动并尝试连接 'lancedb_server' 时，客户端会根据配置自动运行 'uv run mcp-lance-db' 命令来启动 MCP 服务器。或者，你也可以在终端中手动运行 'uv run mcp-lance-db' 命令启动服务器。
客户端交互: 在 LLM 应用中，当需要存储信息时，可以调用 'add-memory' 工具，并提供要存储的文本内容作为参数。当 LLM 需要检索信息时，可以调用 'search-memories' 工具，并提供查询语句作为参数。服务器将返回搜索到的相关记忆。

关键词