Supavec MCP Server

Supavec MCP 服务

一个 Model Context Protocol（MCP） 服务，可让 AI 助手从 Supavec 获取相关嵌入和内容。

功能

• 🔍 获取嵌入：使用嵌入搜索并检索 Supavec 文件中的相关内容
• 🤖 AI 集成：支持 Cursor、Claude、VS Code Copilot 和其他兼容 MCP 的工具
• 🔑 灵活的身份验证：支持通过命令行参数和环境变量进行身份验证
• ⚡ 轻松设置：通过 npx 一条命令即可安装

安装

使用 npx 快速开始（推荐）

无需安装！直接使用 npx：

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

全局安装

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

配置

Cursor

添加到 .cursor/mcp.json：

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

VS Code（Copilot）

添加到 .vscode/mcp.json：

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

Claude Desktop

添加到 Claude 配置中：

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

环境变量

也可以将 API 密钥设置为环境变量：

export SUPAVEC_API_KEY=your_supavec_api_key

然后在 MCP 配置中使用，无需 --api-key 参数：

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

身份验证

获取 API 密钥

1. 访问 Supavec
2. 注册或登录你的账户
3. 前往 API 设置
4. 生成新的 API 密钥

使用优先级

服务按以下顺序检查 API 密钥：

1. --api-key 命令行参数（优先级最高）
2. SUPAVEC_API_KEY 环境变量

可用工具

fetch-embeddings

根据文件 ID 和查询获取文件的嵌入。

参数：

• file_id（字符串，必填）：要获取嵌入的文件 ID
• query（字符串，必填）：要在文件中搜索的查询内容

示例：

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

list-user-files

列出当前用户上传到 Supavec 的所有文件。

参数：

• limit（数字，可选）：要获取的文件数量（默认值：10）
• offset（数字，可选）：分页偏移量（默认值：0）
• order_dir（字符串，可选）：结果的排序方向，可为 "asc" 或 "desc"（默认值："desc"）

示例：

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

响应包含：

• 文件 ID 和名称
• 文件类型和创建日期
• 团队 ID
• 分页信息

命令行用法

帮助

supavec-mcp --help

使用 API 密钥

supavec-mcp --api-key your_api_key_here

使用环境变量

export SUPAVEC_API_KEY=your_api_key_here
supavec-mcp

示例

与 Cursor 配合使用

1. 在 .cursor/mcp.json 中配置 Supavec MCP
2. 打开 Cursor 并开始新对话
3. 提问："在我的 Supavec 文件 xyz789 中搜索有关“数据库设置”的信息"
4. AI 将使用 Supavec MCP 获取相关内容

与 Claude 配合使用

1. 在 Claude 设置中配置 Supavec MCP
2. 在对话中提问："查找文件 abc123 中有关 API 端点的文档"
3. Claude 将搜索你的 Supavec 文件并返回相关信息

故障排除

常见问题

“Error: Supavec API key is required”

• 确保已通过 --api-key 或 SUPAVEC_API_KEY 环境变量提供 API 密钥

“Failed to fetch data: status 401”

• API 密钥可能无效或已过期。请检查 Supavec 账户设置

“Failed to fetch data: status 404”

• 文件 ID 可能不存在，或者你无权访问该文件

调试模式

使用环境变量运行以查看更多详情：

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

开发

要求

• Node.js 16.0.0 或更高版本
• TypeScript

设置

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

测试

# Test with MCP Inspector
npm run inspector

# Test command line
npm run build
node build/index.js --help

贡献

1. Fork 此仓库
2. 创建功能分支：git checkout -b feature-name
3. 进行修改并添加测试
4. 提交修改：git commit -am 'Add feature'
5. 推送到分支：git push origin feature-name
6. 提交拉取请求

许可证

MIT 许可证——详情请参阅 LICENSE。

支持

• 📚 Supavec 文档
• 🐛 报告问题
• 💬 社区支持

Related

• Model Context Protocol
• Supavec Platform
• MCP Servers