关键词

Pinecone向量数据库语义搜索知识库文档管理

Pinecone MCP Server使用说明

项目简介

Pinecone MCP Server (mcp-pinecone) 是一个基于 Model Context Protocol (MCP) 构建的服务器，它将 Anthropic 的 Claude Desktop 等 MCP 客户端连接到 Pinecone 向量数据库。通过该服务器，用户可以使用 Claude Desktop 与存储在 Pinecone 中的知识库进行交互，实现语义搜索、文档读取和更新等功能。

主要功能点

  • 资源管理: 列出和读取 Pinecone 向量数据库中存储的文档资源。每个文档都被视为一个资源，可以通过其在 Pinecone 中的ID进行访问。
  • 语义搜索: 利用 'semantic-search' 工具，用户可以输入自然语言查询，服务器将在 Pinecone 知识库中执行语义搜索，并返回最相关的文档片段。
  • 文档操作:
    • 'read-document' 工具允许用户通过文档ID从 Pinecone 知识库中读取特定文档的内容。
    • 'upsert-document' 工具支持用户向 Pinecone 知识库中添加或更新文档。服务器会自动将文档内容分块并生成向量嵌入，存储到 Pinecone 索引中。
  • Prompt模板: 提供 'brain-query' Prompt 模板，该模板结合了语义搜索工具，允许用户基于 Pinecone 知识库中的上下文提问，并获得基于检索结果的答案。

安装步骤

  1. 安装服务器: 推荐使用 'uv' 工具安装 'mcp-pinecone' 服务器。打开终端并执行以下命令：

    uv pip install mcp-pinecone

    或者

    uvx install mcp-pinecone

    如果您的环境中没有 'uv'，请先参考 uv 安装文档 进行安装。

  2. 配置 Pinecone:

    • 注册 Pinecone 账号: 访问 Pinecone 官网 注册并登录账号。
    • 创建 Pinecone 索引: 在 Pinecone 控制台中创建一个新的索引。请记下您的 Index Name (索引名称)。
    • 获取 API Key: 在 Pinecone 控制台中找到并复制您的 API Key (API 密钥)。

服务器配置

要将 Pinecone MCP Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的服务器设置。以下是针对 Claude Desktop 的配置示例，请根据您的 MCP 客户端进行相应配置。

Claude Desktop 配置 (JSON 格式)

打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。

  • MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在 'mcpServers' 字段下添加 'mcp-pinecone' 服务器的配置信息。

开发/未发布服务器配置示例: 如果您本地安装了 'mcp-pinecone'，可以使用以下配置：

"mcpServers": {
  "mcp-pinecone": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "mcp-pinecone"
    ]
  }
}
  • 'command': 启动服务器的命令，这里使用 'uv'。如果 'uv' 不在您的 PATH 环境变量中，请使用 'which uv' 命令查找 'uv' 的完整路径并替换。
  • 'args': 传递给 'uv' 命令的参数。
    • '--directory': 指定项目目录，'{project_dir}' 需要替换为 'mcp-pinecone' 项目的实际路径（如果您的 Claude Desktop 支持项目目录变量）。
    • 'run mcp-pinecone': 运行 'mcp-pinecone' 服务器的命令。

发布服务器配置示例: 如果您希望以发布模式配置服务器，可以直接在 'args' 中传入 Pinecone 的索引名称和 API 密钥：

"mcpServers": {
  "mcp-pinecone": {
    "command": "uvx",
    "args": [
      "--index-name",
      "{your-index-name}",  // 请替换为您的 Pinecone 索引名称
      "--api-key",
      "{your-secret-api-key}", // 请替换为您的 Pinecone API 密钥
      "mcp-pinecone"
    ]
  }
}
  • 'command': 启动已发布服务器的命令，这里使用 'uvx'。
  • 'args': 传递给 'uvx' 命令的参数。
    • '--index-name': 您的 Pinecone 索引名称，请替换 '{your-index-name}'。
    • '--api-key': 您的 Pinecone API 密钥，请替换 '{your-secret-api-key}'。
    • 'mcp-pinecone': 运行 'mcp-pinecone' 服务器的命令。

请务必将 '{your-index-name}' 和 '{your-secret-api-key}' 替换为您在 Pinecone 控制台中获取的实际信息。

基本使用方法

  1. 启动配置好的 MCP 服务器。
  2. 在 Claude Desktop 或其他 MCP 客户端中，您应该能够看到 'mcp-pinecone' 服务器提供的功能。
  3. 您可以使用 'semantic-search' 工具进行语义搜索，使用 'read-document' 和 'upsert-document' 工具管理 Pinecone 知识库中的文档。
  4. 使用 'brain-query' Prompt 模板，您可以向 Claude 提出问题，并让其基于 Pinecone 知识库中的信息进行回答。

开发与调试

如果您需要进行开发或调试，请参考仓库 README 中的 "Development" 和 "Debugging" 部分，使用 MCP Inspector 可以帮助您更方便地调试 MCP 服务器。

信息

分类

数据库与文件

访问项目