适合谁
- 使用 Pinecone 作为其技术栈一部分的开发者。
- 希望在其开发环境中使用 AI 助手管理 Pinecone 项目和索引的用户。
- 需要与 Pinecone 文档交互或根据配置生成代码的情况。
P
46FMRS · D
该 MCP 服务器专为开发者设计，用于将 Pinecone 与 AI 编码助手集成。它提供了丰富的工具集，覆盖文档搜索、索引管理、数据操作和高级搜索功能。安装配置简单，支持 Cursor、Claude Desktop 和 Gemini CLI。但限制为仅支持集成推理的索引，其他用户需考虑替代方案。
Pinecone Developer MCP 服务器允许 AI 助手（如 Cursor、Claude Desktop 和 Gemini CLI）与 Pinecone 项目和文档交互。它支持搜索文档、管理索引、使用集成推理进行数据插入和查询，以及进行跨索引搜索和重排序。该服务器专注于改善使用 Pinecone 的开发者体验，适用于编码助手。
工具能力
search-docs
搜索 Pinecone 官方文档。
list-indexes
列出所有 Pinecone 索引。
describe-index
描述索引的配置。
describe-index-stats
提供索引中数据的统计信息，包括记录数和可用命名空间。
create-index-for-model
创建一个使用集成推理模型将文本嵌入为向量的新索引。
upsert-records
使用集成推理在索引中插入或更新记录。
search-records
基于文本查询搜索索引中的记录，使用集成推理进行嵌入，并支持元数据过滤和重排序。
cascading-search
跨多个索引搜索记录，对结果进行去重和重排序。
rerank-documents
使用专门的重排序模型对记录或文本文档集合进行重排序。
安装接入
生成 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 环境变量。
claude_desktop_config.json
{
"mcpServers": {
"pinecone": {
"command": "npx",
"args": [
"-y",
"@pinecone-database/mcp"
],
"env": {
"PINECONE_API_KEY": "<your pinecone api key>"
}
}
}
}
选型与风险
不适合谁
- 仅使用无集成推理的索引，或需要独立嵌入、向量搜索及助手功能的用户。
- 需要从知识库为 AI 助手提供上下文的场景（应使用 Pinecone Assistant MCP）。
- 非开发者用途或非编码助手场景。
所需权限
- 需要 PINECONE_API_KEY 环境变量以访问您的 Pinecone 项目。
- 允许 AI 工具创建、列出、描述和删除索引（具体操作取决于工具集）。
- 允许 upsert 和搜索记录，以及跨索引搜索和重排序操作。
- 允许搜索官方 Pinecone 文档（无需 API 密钥）。
风险与副作用
- API 密钥泄露风险：确保密钥安全，不要提交到版本控制。
- 误操作风险：AI 助手可能意外创建、修改或删除索引，建议谨慎授权。
- 成本风险：索引操作和数据使用可能产生费用，请关注用量。
- 网络依赖：需要访问 api.pinecone.io，处于防火墙后可能失败。
常见排障
- MCP 服务器未出现在工具中：检查 Node.js 版本、npx 是否在 PATH 中、配置文件位置和 JSON 语法，并重启工具。
- 无效 API 密钥：在控制台验证密钥，检查环境变量设置，确保没有多余空格或引号。
- 工具不工作：确认索引支持集成推理，否则需要创建新索引；查看 MCP 服务器日志。
- 连接问题：检查防火墙允许访问 api.pinecone.io，或手动运行服务器获取详细错误。
使用场景
在编码助手中搜索 Pinecone 文档以准确回答问题。
根据应用需求配置索引，并生成基于索引配置和数据的代码。
在开发环境中测试对索引的 upsert 和搜索查询，评估结果。
列出所有索引及其配置，检查数据统计，探索命名空间。
使用集成推理搜索记录，应用元数据过滤和重排序。
支持客户端
Cursor完整支持
Claude Desktop完整支持
Gemini CLI完整支持