Lancedb MCP Server

🚀 LanceDB MCP サーバ

LanceDB ベクトルデータベースの操作を行うためのモデルコンテキストプロトコル（MCP）サーバの実装です。このサーバを使用することで、ベクトルの保存、類似性検索、および埋め込みベクトルに関連付けられたメタデータの管理を効率的に行うことができます。

🚀 クイックスタート

この LanceDB MCP サーバは、LanceDB ベクトルデータベースの操作を効率的に行うためのものです。以下の手順でサーバを起動し、利用することができます。

✨ 主な機能

• ベクトルデータベース表をリソースとして公開し、可配置なベクトル次元、テキストメタデータのサポート、効率的な類似性検索機能を提供します。
• 表の管理、ベクトルの追加、類似ベクトルの検索などの API エンドポイントを備えています。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/lancedb_mcp.git
cd lancedb_mcp

# uv を使用して依存関係をインストールする
uv pip install -e .

💻 使用例

基本的な使用法

表の作成

# 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                  # 結果数
}

高度な使用法

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 ファイルを参照してください。