LanceDB MCP Server

概述

LanceDB向量数据库操作的模型上下文协议（MCP）服务器实现。此服务器支持高效的向量存储、相似性搜索以及与元数据关联的向量嵌入管理。

组件

资源

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

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

API 端点

表管理

• POST /table
  • 创建一个新的向量表
  • 输入：

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

向量操作

• POST /table/{table_name}/vector

  • 向表中添加向量数据
  • 输入：

    {
      "vector": [0.1, 0.2, ...],  # 向量数据
      "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文件。