Pinecone MCP Server

官方

将你的 Pinecone 项目连接到 Cursor、Claude 等 AI 助手

分类: 数据库第 49 / 58
Stars: ★ 71 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 59 天前
工具数: 9

46FMRS · D

该 MCP 服务器专为开发者设计，用于将 Pinecone 与 AI 编码助手集成。它提供了丰富的工具集，覆盖文档搜索、索引管理、数据操作和高级搜索功能。安装配置简单，支持 Cursor、Claude Desktop 和 Gemini CLI。但限制为仅支持集成推理的索引，其他用户需考虑替代方案。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

9/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 5/20: 本次审查仅提供了 README 和仓库元数据，没有源码、测试或 CI 工作流文件，无法验证服务器能否成功完成 MCP 初始化握手，也无法确认声明的工具列表与实际行为一致。README 中虽有 CI 徽章，但属不可信证据。仓库有 28 个未关闭 issue，进一步增加了不确定性。因缺乏可验证的执行证据，依据静态校准规则，可靠性不授予高于 12 分，实际给 5 分。
安全与权限 8/20: 唯一凭据是 PINECONE_API_KEY，通过环境变量传入，示例中使用的是占位符而非真实令牌，未发现恶意或窃取凭据行为。工具含 create-index 和 upsert 等写操作，但不涉及删除、支付或远程命令，客户端可能提示授权但服务端未见显式确认机制。未发现最小权限范围的说明或完整数据流披露，但也没有触碰红线，给予 8 分。
维护活跃度 9/20: 仓库未归档，采用 Apache-2.0 许可证，说明存在基本所有权和许可路径。但所提供材料中看不到提交历史、发布节奏、依赖更新或安全响应渠道；28 个未关闭 issue 显示可能存在积压。README 声称的 CI 状态不可信，因此不能给予更高分，给予 9 分。
文档质量 12/20: README 提供了 Cursor、Claude desktop、Gemini CLI 的安装配置示例、API key 设置、工具列表、限制说明（仅支持 integrated inference 索引）和常见问题排查。但是缺少每个工具的详细参数说明、成本提示及更深层的使用示例，部分假设（如网络环境需能访问 api.pinecone.io）只在故障排查中隐含提及。文档总体可用但存在缺口，给予 12 分。
安装易用性 12/20: README 给出了清晰的几步配置路径：要求 Node.js 18+ 和 npx，并分别提供了 Cursor、Claude desktop、Gemini CLI 的 JSON 配置或命令行示例。流程看起来简单直接，但静态校准规定没有可验证的执行证据（真实 CI 和测试）时 setup 最高不超过 15 分；且无法确认 npm 包可用性和网络依赖，因此给予 12 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 Pinecone 作为其技术栈一部分的开发者。
希望在其开发环境中使用 AI 助手管理 Pinecone 项目和索引的用户。
需要与 Pinecone 文档交互或根据配置生成代码的情况。

不适合谁

仅使用无集成推理的索引，或需要独立嵌入、向量搜索及助手功能的用户。
需要从知识库为 AI 助手提供上下文的场景（应使用 Pinecone Assistant MCP）。
非开发者用途或非编码助手场景。

所需权限

需要 PINECONE_API_KEY 环境变量以访问您的 Pinecone 项目。
允许 AI 工具创建、列出、描述和删除索引（具体操作取决于工具集）。
允许 upsert 和搜索记录，以及跨索引搜索和重排序操作。
允许搜索官方 Pinecone 文档（无需 API 密钥）。

风险与副作用

API 密钥泄露风险：确保密钥安全，不要提交到版本控制。
误操作风险：AI 助手可能意外创建、修改或删除索引，建议谨慎授权。
成本风险：索引操作和数据使用可能产生费用，请关注用量。
网络依赖：需要访问 api.pinecone.io，处于防火墙后可能失败。

安装接入

准备工作

运行环境：Node.js 18+

PINECONE_API_KEY 可选密钥 Pinecone API 密钥，用于管理和查询索引；在 Pinecone 控制台 https://app.pinecone.io 生成。未设置时仍可搜索文档。

生成 Pinecone API 密钥（从控制台）。确保 Node.js v18 或更高版本已安装，且 node 和 npx 在 PATH 中可用。

配置 Cursor：在项目根目录创建 .cursor/mcp.json，并添加配置（见 install_config）。检查状态：Cursor 设置 > MCP。

配置 Claude Desktop：通过设置 > 开发者 > 编辑配置找到 claude_desktop_config.json，添加相同配置，然后重启。

作为 Gemini CLI 扩展：运行 gemini extensions install https://github.com/pinecone-io/pinecone-mcp，并设置 PINECONE_API_KEY 环境变量。

.cursor/mcp.json

{
  "mcpServers": {
    "pinecone": {
      "command": "npx",
      "args": [
        "-y",
        "@pinecone-database/mcp"
      ],
      "env": {
        "PINECONE_API_KEY": "<your pinecone api key>"
      }
    }
  }
}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "pinecone": {
      "command": "npx",
      "args": [
        "-y",
        "@pinecone-database/mcp"
      ],
      "env": {
        "PINECONE_API_KEY": "<your pinecone api key>"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add pinecone -e 'PINECONE_API_KEY=<your pinecone api key>' -- npx -y @pinecone-database/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Cursor 中打开 Cursor Settings > MCP 检查服务器状态；连接成功后可用提示词“List all my Pinecone indexes”验证，工具列表中应出现 search-docs、list-indexes 等工具。

常见排障

MCP 服务器未出现在工具中：检查 Node.js 版本、npx 是否在 PATH 中、配置文件位置和 JSON 语法，并重启工具。
无效 API 密钥：在控制台验证密钥，检查环境变量设置，确保没有多余空格或引号。
工具不工作：确认索引支持集成推理，否则需要创建新索引；查看 MCP 服务器日志。
连接问题：检查防火墙允许访问 api.pinecone.io，或手动运行服务器获取详细错误。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索 Pinecone 文档中关于 metadata filtering 的信息
列出我所有的 Pinecone 索引并描述它们的配置
创建一个名为 my-docs、使用 multilingual-e5-large 模型的新索引
在我的索引中搜索与 authentication best practices 相关的记录

工具能力 9

search-docs 只读

搜索 Pinecone 官方文档。

list-indexes 只读

列出所有 Pinecone 索引。

describe-index 只读

描述索引的配置。

describe-index-stats 只读

提供索引中数据的统计信息，包括记录数和可用命名空间。

create-index-for-model 写入

创建一个使用集成推理模型将文本嵌入为向量的新索引。

upsert-records 写入

使用集成推理在索引中插入或更新记录。

search-records 只读

基于文本查询搜索索引中的记录，使用集成推理进行嵌入，并支持元数据过滤和重排序。

cascading-search 只读

跨多个索引搜索记录，对结果进行去重和重排序。

展开其余 1 个工具

rerank-documents 只读

使用专门的重排序模型对记录或文本文档集合进行重排序。

使用场景

在编码助手中搜索 Pinecone 文档以准确回答问题。

根据应用需求配置索引，并生成基于索引配置和数据的代码。

在开发环境中测试对索引的 upsert 和搜索查询，评估结果。

列出所有索引及其配置，检查数据统计，探索命名空间。

使用集成推理搜索记录，应用元数据过滤和重排序。

支持客户端

Cursor

Claude Desktop

Gemini CLI

依据项目文档列出，未经本站实测。

详细介绍

Pinecone Developer MCP 服务器允许 AI 助手（如 Cursor、Claude Desktop 和 Gemini CLI）与 Pinecone 项目和文档交互。它支持搜索文档、管理索引、使用集成推理进行数据插入和查询，以及进行跨索引搜索和重排序。该服务器专注于改善使用 Pinecone 的开发者体验，适用于编码助手。