Supavec

Busque embeddings e conteúdos relevantes do Supavec para assistentes de IA.

GitHub
4

Documentação

Servidor MCP Supavec

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA busquem embeddings e conteúdo relevante do Supavec.

Recursos

  • 🔍 Buscar Embeddings: Pesquise e recupere conteúdo relevante dos arquivos do Supavec usando embeddings
  • 🤖 Integração com IA: Funciona com Cursor, Claude, VS Code Copilot e outras ferramentas compatíveis com MCP
  • 🔑 Autenticação Flexível: Suporte para argumentos de linha de comando e variáveis de ambiente
  • ⚡ Configuração Fácil: Instalação com um comando via npx

Instalação

Início Rápido com npx (Recomendado)

Nenhuma instalação necessária! Use diretamente com npx:

npx @supavec/mcp-server --api-key your_api_key

Instalação Global

npm install -g @supavec/mcp-server
supavec-mcp --api-key your_api_key

Configuração

Cursor

Adicione ao seu .cursor/mcp.json:

{
  "mcpServers": {
    "supavec": {
      "command": "npx",
      "args": [
        "-y",
        "@supavec/mcp-server@latest",
        "--api-key",
        "your_supavec_api_key"
      ]
    }
  }
}

VS Code (Copilot)

Adicione ao seu .vscode/mcp.json:

{
  "servers": {
    "supavec": {
      "command": "npx",
      "args": [
        "-y", 
        "@supavec/mcp-server@latest",
        "--api-key",
        "your_supavec_api_key"
      ]
    }
  }
}

Claude Desktop

Adicione à sua configuração do Claude:

{
  "mcpServers": {
    "supavec": {
      "command": "npx",
      "args": [
        "-y",
        "@supavec/mcp-server@latest", 
        "--api-key",
        "your_supavec_api_key"
      ]
    }
  }
}

Variáveis de Ambiente

Alternativamente, defina sua chave de API como uma variável de ambiente:

export SUPAVEC_API_KEY=your_supavec_api_key

Em seguida, use na sua configuração MCP sem o argumento --api-key:

{
  "mcpServers": {
    "supavec": {
      "command": "npx",
      "args": ["-y", "@supavec/mcp-server@latest"]
    }
  }
}

Autenticação

Obtenha Sua Chave de API

  1. Visite Supavec
  2. Cadastre-se ou faça login na sua conta
  3. Navegue até as configurações da sua API
  4. Gere uma nova chave de API

Prioridade de Uso

O servidor verifica as chaves de API nesta ordem:

  1. Argumento de linha de comando --api-key (prioridade mais alta)
  2. Variável de ambiente SUPAVEC_API_KEY

Ferramentas Disponíveis

fetch-embeddings

Busque embeddings para um arquivo por ID e consulta.

Parâmetros:

  • file_id (string, obrigatório): ID do arquivo para obter embeddings
  • query (string, obrigatório): Consulta para pesquisar no arquivo

Exemplo:

Ask your AI assistant: "Using Supavec, find information about 'authentication' in file abc123"

list-user-files

Liste todos os arquivos enviados para o Supavec para o usuário atual.

Parâmetros:

  • limit (número, opcional): Número de arquivos a buscar (padrão: 10)
  • offset (número, opcional): Deslocamento para paginação (padrão: 0)
  • order_dir (string, opcional): Direção da ordem dos resultados - "asc" ou "desc" (padrão: "desc")

Exemplo:

Ask your AI assistant: "List my Supavec files" or "Show me the first 20 files from my Supavec account"

A resposta inclui:

  • ID e nome do arquivo
  • Tipo do arquivo e data de criação
  • ID da equipe
  • Informações de paginação

Uso da Linha de Comando

Ajuda

supavec-mcp --help

Com Chave de API

supavec-mcp --api-key your_api_key_here

Com Variável de Ambiente

export SUPAVEC_API_KEY=your_api_key_here
supavec-mcp

Exemplos

Usando com Cursor

  1. Configure o Supavec MCP em .cursor/mcp.json
  2. Abra o Cursor e inicie um novo chat
  3. Pergunte: "Pesquise por informações de 'configuração de banco de dados' no meu arquivo Supavec xyz789"
  4. A IA usará o Supavec MCP para buscar conteúdo relevante

Usando com Claude

  1. Configure o Supavec MCP nas configurações do Claude
  2. Em uma conversa, pergunte: "Encontre documentação sobre endpoints de API no arquivo abc123"
  3. O Claude pesquisará seus arquivos Supavec e retornará informações relevantes

Solução de Problemas

Problemas Comuns

"Erro: Chave de API do Supavec é obrigatória"

  • Certifique-se de ter fornecido uma chave de API via variável de ambiente --api-key ou SUPAVEC_API_KEY

"Falha ao buscar dados: status 401"

  • Sua chave de API pode ser inválida ou expirada. Verifique as configurações da sua conta Supavec

"Falha ao buscar dados: status 404"

  • O ID do arquivo pode não existir ou você pode não ter acesso a ele

Modo de Depuração

Execute com variáveis de ambiente para ver mais detalhes:

DEBUG=1 supavec-mcp --api-key your_key

Desenvolvimento

Requisitos

  • Node.js 16.0.0 ou superior
  • TypeScript

Configuração

git clone https://github.com/supavec/mcp-server.git
cd supavec-mcp-server
npm install
npm run build

Testes

# Test with MCP Inspector
npm run inspector

# Test command line
npm run build
node build/index.js --help

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de recurso: git checkout -b feature-name
  3. Faça suas alterações e adicione testes
  4. Faça commit das suas alterações: git commit -am 'Add feature'
  5. Envie para o branch: git push origin feature-name
  6. Envie um pull request

Licença

Licença MIT - veja LICENÇA para detalhes.

Suporte

Relacionados