Supavec MCP Server

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

Local serverstdioTypeScript

What is the Supavec MCP server?

Supavec MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. A Model Context Protocol (MCP) server for Supavec that enables AI assistants to fetch relevant embeddings and content.

What you get

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

  • 🔍 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

What the assistant can call

Once Supavec is connected, these are the calls the assistant has available:

  • Cursor — The Cursor tool exposed by this server
  • Help — The Help tool exposed by this server
  • Requirements — The Requirements tool exposed by this server
  • Setup — The Setup tool exposed by this server
  • Testing — The Testing tool exposed by this server

Configuration and credentials

You will need one environment variable: SUPAVEC_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js 16.0.0 or higher - TypeScript

Setting it up

Installation goes through your MCP client rather than a global install: point it at @supavec/mcp-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Supavec's toolset — Cursor, Help, Requirements and 2 more — is a fair guide to whether it matches your workflow. It is maintained by taishikato; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Supavec's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the supavec mcp server does with a few real requests.

Available tools

ToolWhat it does
CursorThe Cursor tool exposed by this server.
HelpThe Help tool exposed by this server.
RequirementsThe Requirements tool exposed by this server.
SetupThe Setup tool exposed by this server.
TestingThe Testing tool exposed by this server.

How to install the Supavec MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 16.0.0 or higher - TypeScript
VariableDescriptionRequired
SUPAVEC_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Supavec to Cursor.
  • Use Supavec to Help.
  • Use Supavec to Requirements.

Frequently asked questions

It connects Supavec to MCP-compatible AI assistants such as Claude and Cursor, exposing 5 tools (Cursor, Help, Requirements, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Supavec directly.