Servidor MCP LanceDB

Visão Geral

Uma implementação de servidor Model Context Protocol (MCP) para operações de banco de dados vetorial LanceDB. Este servidor permite armazenamento eficiente de vetores, busca por similaridade e gerenciamento de embeddings vetoriais com metadados associados.

Componentes

Recursos

O servidor expõe tabelas de banco de dados vetorial como recursos:

table://{name}: Uma tabela de banco de dados vetorial que armazena embeddings e metadados
- Dimensões de vetor configuráveis
- Suporte a metadados de texto
- Capacidades eficientes de busca por similaridade

Endpoints da API

Gerenciamento de Tabelas

POST /table

Criar uma nova tabela vetorial

Entrada:

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

Operações Vetoriais

POST /table/{table_name}/vector

Adicionar dados vetoriais a uma tabela

Entrada:

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

POST /table/{table_name}/search

Buscar vetores similares

Entrada:

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

Instalação

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

# Install dependencies using uv
uv pip install -e .

Uso com Claude Desktop

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

Desenvolvimento

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

# Run tests
pytest

# Format code
black .
ruff .

Variáveis de Ambiente

LANCEDB_URI: Caminho para o armazenamento LanceDB (padrão: ".lancedb")

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

LanceDB

Documentação