LanceDB MCP 服务器

概述

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

Related MCP server: KGrag MCP Server

成分

资源

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

• table://{name} ：存储嵌入和元数据的向量数据库表

  • 可配置向量维度

  • 文本元数据支持

  • 高效的相似性搜索功能

API 端点

表管理

• POST /table

  • 创建新的向量表

  • 输入：

    {
      "name": "my_table",      # Table name
      "dimension": 768         # Vector dimension
    }

向量运算

• POST /table/{table_name}/vector

  • 向表中添加矢量数据

  • 输入：

    {
      "vector": [0.1, 0.2, ...],  # Vector data
      "text": "associated text"    # Metadata
    }

• POST /table/{table_name}/search

  • 搜索相似向量

  • 输入：

    {
      "vector": [0.1, 0.2, ...],  # Query vector
      "limit": 10                  # Number of results
    }

安装

# Clone the repository
git clone https://github.com/yourusername/lancedb_mcp.git
cd lancedb_mcp

# Install dependencies using uv
uv pip install -e .

与 Claude Desktop 一起使用

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "lancedb": {
    "command": "uv",
    "args": [
      "run",
      "python",
      "-m",
      "lancedb_mcp",
      "--db-path",
      "~/.lancedb"
    ]
  }
}

发展

# Install development dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

# Format code
black .
ruff .

环境变量

• LANCEDB_URI ：LanceDB 存储路径（默认值：“.lancedb”）

执照

本项目遵循 MIT 许可证。详情请参阅 LICENSE 文件。