Skip to main content
Glama

Supavec MCP Server

by supavec

Supavec MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to fetch relevant embeddings and content from Supavec.

Features

  • 🔍 Fetch Embeddings: Search and retrieve relevant content from Supavec files using embeddings
  • 🤖 AI Integration: Works with Cursor, Claude, VS Code Copilot, and other MCP-compatible tools
  • 🔑 Flexible Authentication: Support for both command-line arguments and environment variables
  • Easy Setup: One-command installation via npx

Installation

No installation required! Use directly with npx:

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

Global Installation

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

Configuration

Cursor

Add to your .cursor/mcp.json:

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

VS Code (Copilot)

Add to your .vscode/mcp.json:

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

Claude Desktop

Add to your Claude configuration:

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

Environment Variables

Alternatively, set your API key as an environment variable:

export SUPAVEC_API_KEY=your_supavec_api_key

Then use in your MCP configuration without the --api-key argument:

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

Authentication

Get Your API Key

  1. Visit Supavec
  2. Sign up or log in to your account
  3. Navigate to your API settings
  4. Generate a new API key

Usage Priority

The server checks for API keys in this order:

  1. --api-key command line argument (highest priority)
  2. SUPAVEC_API_KEY environment variable

Available Tools

fetch-embeddings

Fetch embeddings for a file by ID and query.

Parameters:

  • file_id (string, required): ID of the file to get embeddings for
  • query (string, required): Query to search for in the file

Example:

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

list-user-files

List all files uploaded to Supavec for the current user.

Parameters:

  • limit (number, optional): Number of files to fetch (default: 10)
  • offset (number, optional): Offset for pagination (default: 0)
  • order_dir (string, optional): Order direction for results - "asc" or "desc" (default: "desc")

Example:

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

Response includes:

  • File ID and name
  • File type and creation date
  • Team ID
  • Pagination information

Command Line Usage

Help

supavec-mcp --help

With API Key

supavec-mcp --api-key your_api_key_here

With Environment Variable

export SUPAVEC_API_KEY=your_api_key_here supavec-mcp

Examples

Using with Cursor

  1. Configure Supavec MCP in .cursor/mcp.json
  2. Open Cursor and start a new chat
  3. Ask: "Search for 'database setup' information in my Supavec file xyz789"
  4. The AI will use the Supavec MCP to fetch relevant content

Using with Claude

  1. Configure Supavec MCP in Claude settings
  2. In a conversation, ask: "Find documentation about API endpoints in file abc123"
  3. Claude will search your Supavec files and return relevant information

Troubleshooting

Common Issues

"Error: Supavec API key is required"

  • Ensure you've provided an API key via --api-key or SUPAVEC_API_KEY environment variable

"Failed to fetch data: status 401"

  • Your API key may be invalid or expired. Check your Supavec account settings

"Failed to fetch data: status 404"

  • The file ID may not exist or you may not have access to it

Debug Mode

Run with environment variables to see more details:

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

Development

Requirements

  • Node.js 16.0.0 or higher
  • TypeScript

Setup

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

Testing

# Test with MCP Inspector npm run inspector # Test command line npm run build node build/index.js --help

Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature-name
  3. Make your changes and add tests
  4. Commit your changes: git commit -am 'Add feature'
  5. Push to the branch: git push origin feature-name
  6. Submit a pull request

License

MIT License - see LICENSE for details.

Support

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables fetching relevant content and embeddings from Supavec via the Model Context Protocol, allowing AI assistants like Claude to access vector search capabilities.

  1. Tools
    1. Usage
      1. Build it
      2. Get your Supavec API key
      3. With Claude for Desktop
      4. Standalone or for other projects
    2. License

      Related MCP Servers

      • -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that enables querying feature suggestions from a Supabase database, allowing AI tools like Cursor and Claude to access and display feature request data.
        Last updated -
        TypeScript
      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol server that enables Claude and other LLMs to perform database operations and invoke Edge Functions within Supabase through natural language.
        Last updated -
        823
        3
        TypeScript
        MIT License
      • -
        security
        A
        license
        -
        quality
        Provides access to various AI tools through Model Context Protocol, allowing Claude Desktop users to integrate and use Superface capabilities via API.
        Last updated -
        5
        4
        JavaScript
        MIT License
      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol server that enables AI tools to interact with Supabase databases, providing tools for reading, creating, updating, and deleting records in Supabase tables.
        Last updated -
        Python
        MIT License

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/supavec/mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server