Supavec MCP Server

Obtén contenido relevante de Supavec, un servicio de base de datos vectorial.

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 tanto para argumentos de línea de comandos como para variables de entorno
  • ⚡ Configuración fácil: 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, configura tu clave de API como una 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 busca claves de API en este orden:

  1. Argumento de línea de comandos --api-key (prioridad más alta)
  2. Variable de entorno SUPAVEC_API_KEY

Herramientas disponibles

fetch-embeddings

Obtén embeddings de un archivo por ID y consulta.

Parámetros:

  • file_id (string, obligatorio): ID del archivo del que se obtendrán los embeddings
  • query (string, 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 (number, opcional): Número de archivos a obtener (predeterminado: 10)
  • offset (number, opcional): Desplazamiento para paginación (predeterminado: 0)
  • order_dir (string, 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 desde la 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

Uso 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á el Supavec MCP para obtener contenido relevante

Uso 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á 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 puede que no tengas 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. Haz commit de tus cambios: git commit -am 'Add feature'
  5. Sube la rama: git push origin feature-name
  6. Envía un pull request

Licencia

Licencia MIT - consulta LICENSE para más detalles.

Soporte

Relacionados