LanceDB MCP 服务器

概述

LanceDB 向量数据库操作的模型上下文协议 (MCP) 服务器实现。 此服务器能够高效地存储向量、进行相似性搜索以及管理具有相关元数据的向量嵌入。

组件

资源

服务器将向量数据库表公开为资源：

• table://{name}: 存储嵌入和元数据的向量数据库表
  • 可配置的向量维度
  • 文本元数据支持
  • 高效的相似性搜索能力

API 接口

表格管理

• POST /table
  • 创建新的向量表
  • 输入:

    {
      "name": "my_table",      # 表格名称
      "dimension": 768         # 向量维度
    }
    

向量操作

• POST /table/{table_name}/vector

  • 向表格添加向量数据
  • 输入:

    {
      "vector": [0.1, 0.2, ...],  # 向量数据
      "text": "associated text"    # 元数据
    }
    

• POST /table/{table_name}/search

  • 搜索相似向量
  • 输入:

    {
      "vector": [0.1, 0.2, ...],  # 查询向量
      "limit": 10                  # 结果数量
    }
    

安装

# 克隆仓库
git clone https://github.com/yourusername/lancedb_mcp.git
cd lancedb_mcp

# 使用 uv 安装依赖
uv pip install -e .

与 Claude Desktop 一起使用

# 将服务器添加到您的 claude_desktop_config.json
"mcpServers": {
  "lancedb": {
    "command": "uv",
    "args": [
      "run",
      "python",
      "-m",
      "lancedb_mcp",
      "--db-path",
      "~/.lancedb"
    ]
  }
}

开发

# 安装开发依赖
uv pip install -e ".[dev]"

# 运行测试
pytest

# 格式化代码
black .
ruff .

环境变量

• LANCEDB_URI: LanceDB 存储的路径 (默认: ".lancedb")

许可证

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