Supavec

Obtén embeddings y contenido relevantes de Supavec para asistentes de IA.

GitHub
4
Prueba este MCPPatrocinado

Documentación

Supavec MCP Server

Un servidor de Model Context Protocol (MCP) que permite a los asistentes de IA obtener embeddings y contenido relevante de Supavec.

Características

  • 🔍 Obtener Embeddings: Busca y recupera contenido relevante de archivos de Supavec usando embeddings
  • 🤖 Integración con IA: Funciona con Cursor, Claude, VS Code Copilot y otras herramientas compatibles con MCP
  • 🔑 Autenticación Flexible: Soporte para argumentos de línea de comandos y variables de entorno
  • ⚡ Configuración Sencilla: Instalación con un solo comando mediante npx

Instalación

Inicio Rápido con npx (Recomendado)

¡No requiere instalación! Úsalo directamente con npx:

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

Instalación Global

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

Configuración

Cursor

Añade a tu .cursor/mcp.json:

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

VS Code (Copilot)

Añade a tu .vscode/mcp.json:

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

Claude Desktop

Añade a tu configuración de Claude:

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

Variables de Entorno

Alternativamente, establece tu clave de API como variable de entorno:

export SUPAVEC_API_KEY=your_supavec_api_key

Luego úsala en tu configuración de MCP sin el argumento --api-key:

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

Autenticación

Obtén tu Clave de API

  1. Visita Supavec
  2. Regístrate o inicia sesión en tu cuenta
  3. Navega a la configuración de tu API
  4. Genera una nueva clave de API

Prioridad de Uso

El servidor verifica las claves de API en este orden:

  1. Argumento de línea de comandos --api-key (mayor prioridad)
  2. Variable de entorno SUPAVEC_API_KEY

Herramientas Disponibles

fetch-embeddings

Obtiene embeddings de un archivo por ID y consulta.

Parámetros:

  • file_id (cadena, obligatorio): ID del archivo del que obtener embeddings
  • query (cadena, obligatorio): Consulta para buscar en el archivo

Ejemplo:

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

list-user-files

Lista todos los archivos subidos a Supavec para el usuario actual.

Parámetros:

  • limit (número, opcional): Número de archivos a obtener (predeterminado: 10)
  • offset (número, opcional): Desplazamiento para paginación (predeterminado: 0)
  • order_dir (cadena, opcional): Dirección de orden de los resultados - "asc" o "desc" (predeterminado: "desc")

Ejemplo:

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

La respuesta incluye:

  • ID y nombre del archivo
  • Tipo de archivo y fecha de creación
  • ID del equipo
  • Información de paginación

Uso en Línea de Comandos

Ayuda

supavec-mcp --help

Con Clave de API

supavec-mcp --api-key your_api_key_here

Con Variable de Entorno

export SUPAVEC_API_KEY=your_api_key_here
supavec-mcp

Ejemplos

Usando con Cursor

  1. Configura Supavec MCP en .cursor/mcp.json
  2. Abre Cursor e inicia un nuevo chat
  3. Pregunta: "Busca información sobre 'configuración de base de datos' en mi archivo de Supavec xyz789"
  4. La IA usará Supavec MCP para obtener el contenido relevante

Usando con Claude

  1. Configura Supavec MCP en la configuración de Claude
  2. En una conversación, pregunta: "Encuentra documentación sobre endpoints de API en el archivo abc123"
  3. Claude buscará en tus archivos de Supavec y devolverá la información relevante

Solución de Problemas

Problemas Comunes

"Error: Se requiere la clave de API de Supavec"

  • Asegúrate de haber proporcionado una clave de API mediante --api-key o la variable de entorno SUPAVEC_API_KEY

"Error al obtener datos: estado 401"

  • Tu clave de API puede ser inválida o haber expirado. Revisa la configuración de tu cuenta de Supavec

"Error al obtener datos: estado 404"

  • El ID del archivo puede no existir o no tener acceso a él

Modo de Depuración

Ejecuta con variables de entorno para ver más detalles:

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

Desarrollo

Requisitos

  • Node.js 16.0.0 o superior
  • TypeScript

Configuración

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

Pruebas

# Test with MCP Inspector
npm run inspector

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

Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de características: git checkout -b feature-name
  3. Realiza tus cambios y añade pruebas
  4. Confirma tus cambios: git commit -am 'Add feature'
  5. Sube la rama: git push origin feature-name
  6. Envía una solicitud de extracción (pull request)

Licencia

Licencia MIT - consulta LICENSE para más detalles.

Soporte

Relacionados