GitHub Stats

    Stars

    6

    Forks

    3

    Release Date

    4/2/2025

    about 3 months ago

    Detailed Description

    LanceDB MCP Server

    Overview

    A Model Context Protocol (MCP) server implementation for LanceDB vector database operations. This server enables efficient vector storage, similarity search, and management of vector embeddings with associated metadata.

    Components

    Resources

    The server exposes vector database tables as resources:

    • table://{name}: A vector database table that stores embeddings and metadata
      • Configurable vector dimensions
      • Text metadata support
      • 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 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 .
    

    Environment Variables

    • LANCEDB_URI: Path to LanceDB storage (default: ".lancedb")

    License

    This project is licensed under the MIT License. See the LICENSE file for details.

    About the Project

    This app has not been claimed by its owner yet.

    Claim Ownership

    Receive Updates

    Security Updates

    Get notified about trust rating changes

    to receive email notifications.