Perplexity MCP Server 使用说明

项目简介

Perplexity MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它集成 Perplexity API，为 LLM 客户端提供 'ask_perplexity' 工具。该工具允许 LLM 客户端调用 Perplexity API 进行联网搜索和问答，并返回带有引用的结果，适用于需要研究、事实核查或上下文数据的应用场景。

主要功能点

ask_perplexity 工具: 通过 Perplexity API 执行联网搜索和问答，并返回带有引用的答案。
引用支持: 返回结果包含引用的来源，方便用户追溯信息来源，提高信息可信度。
JSON-RPC 协议: 使用标准的 MCP 协议与 LLM 客户端通信。
Stdio 传输: 支持 Stdio 传输协议，方便集成到各种 LLM 客户端，如 Claude Desktop。

安装步骤

安装 Python 环境: 确保您的系统已安装 Python 3.8 或更高版本。

安装 mcp-server-perplexity: 使用 pip 安装 'mcp-server-perplexity' 包。

pip install mcp-server-perplexity

配置 Perplexity API 密钥: 您需要在 Perplexity 平台获取 API 密钥，并将其设置为环境变量 'PERPLEXITY_API_KEY'。例如，在 Linux 或 macOS 系统中，您可以执行：
```
export PERPLEXITY_API_KEY="your-perplexity-api-key"
```
在 Windows 系统中，您可以在系统环境变量中添加 'PERPLEXITY_API_KEY' 变量。

服务器配置

要将 Perplexity MCP Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 的配置示例，您需要将以下 JSON 配置添加到 'claude_desktop_config.json' 文件中。

Claude Desktop 配置文件 (claude_desktop_config.json) 配置示例:

请根据您的操作系统找到 'claude_desktop_config.json' 文件：

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

在 'mcpServers' 字段中添加以下配置：

"mcpServers": {
  "Perplexity": {  // MCP 服务器名称，您可以自定义
    "command": "uvx",  // 启动命令，uvx 是一个通用的 Python 运行器，如果您的环境中安装了 mcp-server-perplexity，可以直接使用 uvx 运行
    "args": [
      "mcp-server-perplexity" //  mcp-server-perplexity 包的可执行入口
    ],
    "env": {
      "PERPLEXITY_API_KEY": "your-perplexity-api-key" //  Perplexity API 密钥，请替换为您的实际密钥，或者确保已在系统环境变量中设置
    }
  }
}

配置说明:

'"Perplexity"': 您为该 MCP 服务器自定义的名称，在 Claude Desktop 客户端中会显示这个名称。
'"command": "uvx"' 和 '"args": ["mcp-server-perplexity"]': 指定了启动 Perplexity MCP Server 的命令。这里使用 'uvx mcp-server-perplexity' 来运行服务器。确保您的环境中 'uvx' 可用，并且 'mcp-server-perplexity' 包已正确安装。
'"env": { "PERPLEXITY_API_KEY": "your-perplexity-api-key" }': 设置环境变量，将您的 Perplexity API 密钥传递给服务器。请务必替换 '"your-perplexity-api-key"' 为您真实的 API 密钥，或者确保您已经在系统环境变量中设置了 'PERPLEXITY_API_KEY'。

基本使用方法

启动 Claude Desktop 客户端。
在 Claude Desktop 中，您应该能看到名为 "Perplexity" (或者您在配置文件中设置的名称) 的 MCP 服务器已连接。
在与 Claude 对话时，您可以使用 '@ask_perplexity' 工具来调用 Perplexity API 进行联网搜索和问答。例如，您可以输入类似 '@ask_perplexity 请告诉我最新的AI发展动态' 的指令。
服务器会将您的请求发送到 Perplexity API，并将返回的结果（包括引用的信息）返回给 Claude Desktop。Claude 会根据返回的结果生成回复。

注意: 由于 Perplexity API 的处理时间可能较长，Claude Desktop 客户端可能会出现超时提示。请参考仓库 README 中关于 Claude Desktop 超时问题的说明。

关键词