Upstash Vector MCP Server

MCP (Model Context Protocol) 服务器，为 AI 助手提供 Upstash 向量数据库操作能力。

快速开始

通过 npx 运行（推荐）

无需安装，直接运行：

npx upstash-vector-mcp

全局安装

npm install -g upstash-vector-mcp
upstash-vector-mcp

本地开发

git clone <repo-url> && cd upstash-mcp
npm install
npm start

环境变量

| 变量名 | 必需 | 说明 | |--------|------|------| | UPSTASH_VECTOR_REST_URL | 是 | Upstash Vector REST URL（从 console.upstash.com 获取） | | UPSTASH_VECTOR_REST_TOKEN | 是 | Upstash Vector REST Token | | DEFAULT_NAMESPACE | 否 | 默认命名空间，空字符串表示默认空间 | | DEFAULT_TOP_K | 否 | 默认返回结果数（默认: 10） | | DEFAULT_INCLUDE_METADATA | 否 | 默认是否包含元数据（默认: true） |

Claude Code 配置

在 Claude Code 的 MCP 配置文件中添加：

{
  "mcpServers": {
    "upstash-vector": {
      "command": "npx",
      "args": ["-y", "upstash-vector-mcp"],
      "env": {
        "UPSTASH_VECTOR_REST_URL": "https://your-vector-url.upstash.io",
        "UPSTASH_VECTOR_REST_TOKEN": "your-token-here"
      }
    }
  }
}

其他 MCP 客户端（如 Cursor、 Windsurf 等）使用相同的 JSON 格式配置。

可用工具

向量操作

| 工具名 | 说明 | |--------|------| | upstash_query_vector | 向量相似性搜索，支持文本或向量输入、元数据过滤、混合查询 | | upstash_upsert_vector | 插入或更新向量，支持单个和批量操作 | | upstash_delete_vector | 删除向量，支持按 ID、前缀或过滤器删除 | | upstash_range_vectors | 游标分页浏览所有向量 |

命名空间管理

| 工具名 | 说明 | |--------|------| | upstash_list_namespaces | 列出所有命名空间 | | upstash_delete_namespace | 删除指定命名空间 | | upstash_reset_namespace | 重置命名空间（清空所有向量） | | upstash_rename_namespace | 重命名命名空间 |

使用示例

语义搜索

{
  "tool": "upstash_query_vector",
  "arguments": {
    "data": "机器学习的基本概念",
    "topK": 5,
    "includeMetadata": true,
    "filter": "category='docs' AND status='active'"
  }
}

插入向量

{
  "tool": "upstash_upsert_vector",
  "arguments": {
    "id": "doc-001",
    "data": "人工智能是计算机科学的一个分支",
    "metadata": { "title": "AI定义", "category": "docs" }
  }
}

批量插入

{
  "tool": "upstash_upsert_vector",
  "arguments": {
    "vectors": [
      { "id": "doc-001", "data": "内容一", "metadata": { "category": "docs" } },
      { "id": "doc-002", "data": "内容二", "metadata": { "category": "docs" } }
    ]
  }
}

命名空间操作

{ "tool": "upstash_list_namespaces", "arguments": {} }

{
  "tool": "upstash_rename_namespace",
  "arguments": { "namespace": "old-name", "newNamespace": "new-name" }
}

要求

• Node.js >= 18.0.0
• Upstash Vector 账号和索引

许可证

MIT License