The Supavec MCP Server enables AI assistants to fetch relevant content and embeddings from Supavec files. With this server, you can:
- Search and Retrieve Content: Query specific file IDs to fetch relevant embeddings and content
- AI Tool Integration: Seamlessly work with AI tools like Cursor, Claude, and VS Code Copilot via Model Context Protocol (MCP)
- Flexible Authentication: Authenticate using either command-line arguments or environment variables
- Easy Setup: Install quickly via npx or global npm commands
The server supports the fetch-embeddings
operation, allowing AI assistants to retrieve context-specific information from your Supavec files.
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
Quick Start with npx (Recommended)
No installation required! Use directly with npx:
Global Installation
Configuration
Cursor
Add to your .cursor/mcp.json
:
VS Code (Copilot)
Add to your .vscode/mcp.json
:
Claude Desktop
Add to your Claude configuration:
Environment Variables
Alternatively, set your API key as an environment variable:
Then use in your MCP configuration without the --api-key
argument:
Authentication
Get Your API Key
- Visit Supavec
- Sign up or log in to your account
- Navigate to your API settings
- Generate a new API key
Usage Priority
The server checks for API keys in this order:
--api-key
command line argument (highest priority)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 forquery
(string, required): Query to search for in the file
Example:
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:
Response includes:
- File ID and name
- File type and creation date
- Team ID
- Pagination information
Command Line Usage
Help
With API Key
With Environment Variable
Examples
Using with Cursor
- Configure Supavec MCP in
.cursor/mcp.json
- Open Cursor and start a new chat
- Ask: "Search for 'database setup' information in my Supavec file xyz789"
- The AI will use the Supavec MCP to fetch relevant content
Using with Claude
- Configure Supavec MCP in Claude settings
- In a conversation, ask: "Find documentation about API endpoints in file abc123"
- 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
orSUPAVEC_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:
Development
Requirements
- Node.js 16.0.0 or higher
- TypeScript
Setup
Testing
Contributing
- Fork the repository
- Create a feature branch:
git checkout -b feature-name
- Make your changes and add tests
- Commit your changes:
git commit -am 'Add feature'
- Push to the branch:
git push origin feature-name
- Submit a pull request
License
MIT License - see LICENSE for details.
Support
Related
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.
Related Resources
Related MCP Servers
- -securityFlicense-qualityA 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
- -securityAlicense-qualityA 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 -8233TypeScriptMIT License
Superface MCP Serverofficial
-securityAlicense-qualityProvides access to various AI tools through Model Context Protocol, allowing Claude Desktop users to integrate and use Superface capabilities via API.Last updated -54JavaScriptMIT License- -securityAlicense-qualityA 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 -PythonMIT License