Lancedb MCP Server

🚀 LanceDB MCP Server

An implementation of the Model Context Protocol (MCP) server for operations on the LanceDB vector database. This server enables efficient vector storage, similarity search, and management of metadata associated with embedded vectors.

🚀 Quick Start

The LanceDB MCP Server provides an efficient way to operate on the LanceDB vector database, including vector storage, similarity search, and metadata management. Follow the steps below to get started.

✨ Features

Resources

The server exposes vector database tables as resources:

• table://{name}: A vector database table for storing embeddings and metadata
  • Configurable vector dimensions
  • Support for text metadata
  • Efficient similarity search capabilities

API Endpoints

Table Management

• POST /table
  • Create a new vector table
  • Input:

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

Vector Operations

• POST /table/{table_name}/vector

  • Add vector data to a table
  • Input:

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

• POST /table/{table_name}/search

  • Search for similar vectors
  • Input:

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

📦 Installation

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

# Install dependencies using uv
uv pip install -e .

💻 Usage Examples

Using with Claude Desktop

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

Development

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

# Run tests
pytest

# Format code
black .
ruff .

🔧 Technical Details

Environment Variables

• LANCEDB_URI: LanceDB storage path (Default: .lancedb)

📄 License

This project is released under the MIT License. For more details, please refer to the LICENSE file.