Supavec

You can run a dedicated MCP server for Supavec to let AI assistants fetch relevant embeddings and content from your Supavec files. This server integrates with MCP-compatible tools, supports flexible authentication, and is simple to set up with a single command.

How to use

Set up your Supavec MCP server and connect it to your MCP client or assistant. You will provide an API key to authorize requests, then configure your client (Cursor, VS Code Copilot, Claude, or other MCP-enabled tools) to use the Supavec MCP server. Once connected, you can ask your AI assistant to search your Supavec files for embeddings and content, and the assistant will fetch the most relevant results.

How to install

Prerequisites: Node.js 16.0.0 or higher. You may also need a package manager such as npm or npx.

npx @supavec/mcp-server --api-key your_api_key
```},

Alternatively, install the MCP server globally and run it from the command line.

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

Configuration

Configure how your MCP client connects to the Supavec MCP server for different environments. Below are example configurations you can paste into your client settings.

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

Environment variables

You can provide your API key via an environment variable instead of passing it on the command line. This keeps the key out of command history and scripts.

export SUPAVEC_API_KEY=your_supavec_api_key

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

Security and keys

The server authenticates requests using an API key. Use the command line argument --api-key or set SUPAVEC_API_KEY in your environment to authorize access.

Troubleshooting

Common issues include missing API keys, invalid keys, or insufficient permissions. Ensure the key is provided via --api-key or SUPAVEC_API_KEY. If you encounter a 401 or 404, verify the key and the file access rights in your Supavec account.

Debug mode can help diagnose problems by providing more verbose output when you run with environment variables.

Examples

Using with Cursor: configure Supavec MCP in your client, open a chat, and ask to search for specific information within a Supavec file.

Using with Claude: configure Supavec MCP in Claude, then ask the assistant to locate documentation within your Supavec files.

Development notes

This server is designed to be lightweight and easy to integrate with MCP-enabled tools. Ensure you keep your API keys secure and rotate them as needed.

Available tools

fetch-embeddings

Fetch embeddings for a file by ID and a query to search within that file.

list-user-files

List all files uploaded by the current user with optional limits, pagination, and order.