Lancedb MCP Server

🚀 LanceDB MCP 服務器

LanceDB MCP 服務器是基於模型上下文協議（MCP）實現的，專門用於操作 LanceDB 向量數據庫。它能高效地進行向量存儲、相似性搜索以及關聯元數據管理，為相關應用提供強大支持。

🚀 快速開始

安裝

# 克隆倉庫
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"
    ]
  }
}

✨ 主要特性

資源

服務器將向量數據庫表以資源形式公開：

• 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 .

💻 使用示例

基礎用法

# 以下是創建表的示例
{
  "name": "my_table",
  "dimension": 768
}

高級用法

# 以下是搜索相似向量的示例
{
  "vector": [0.1, 0.2, ...],
  "limit": 10
}

🔧 技術細節

開發

# 安裝開發依賴項
uv pip install -e ".[dev]"

# 運行測試
pytest

# 格式化代碼
black .
ruff .

環境變量

📄 許可證

該項目在 MIT 許可證下發布。有關詳細信息，請參閱 LICENSE 文件。