Perplexity API 平台 MCP 服务器

   

Perplexity API 平台的官方 MCP 服务器实现，通过 Sonar 模型和 Search API 为 AI 助手提供实时网络搜索、推理和研究能力。

可用工具

perplexity_search

使用 Perplexity Search API 进行直接网络搜索。返回带有元数据的排名搜索结果，非常适合查找最新信息。

perplexity_ask

使用 sonar-pro 模型进行通用对话式 AI，并结合实时网络搜索。非常适合快速问答和日常查询。

perplexity_research

使用 sonar-deep-research 模型进行深入、全面的研究。非常适合详尽分析和详细报告。

perplexity_reason

使用 sonar-reasoning-pro 模型进行高级推理和问题解决。非常适合复杂的分析任务。

[!提示] perplexity_reason 和 perplexity_research 的可选参数：strip_thinking

设置为 true 可移除响应中的 <think>...</think> 标签，从而节省上下文 token。默认值：false

配置

获取您的 API 密钥

1. 从 API 门户 获取您的 Perplexity API 密钥。
2. 将下方配置中的 your_key_here 替换为您自己的 API 密钥。
3. （可选）设置超时时间：PERPLEXITY_TIMEOUT_MS=600000（默认 5 分钟）。
4. （可选）设置自定义基础 URL：PERPLEXITY_BASE_URL=https://your-custom-url.com（默认 https://api.perplexity.ai）。
5. （可选）设置日志级别：PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR（默认 ERROR）。

Claude 代码

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

或者通过插件安装：

export PERPLEXITY_API_KEY="your_key_here"
claude
# 然后运行：/plugin marketplace add perplexityai/modelcontextprotocol
# 然后运行：/plugin install perplexity

Cursor、Claude Desktop 和 Windsurf

我们建议使用本 README 顶部的一键安装按钮来为 Cursor 安装。

对于手动设置，所有这些客户端都使用相同的 mcpServers 格式：

客户端	配置文件
Cursor	~/.cursor/mcp.json
Claude Desktop	claude_desktop_config.json
Windsurf	~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

VS Code

我们建议使用本 README 顶部的一键安装按钮来为 VS Code 安装，或者手动添加到 .vscode/mcp.json：

{
  "servers": {
    "perplexity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

其他 MCP 客户端

大多数客户端都可以手动配置以在其配置文件中使用 mcpServers 包装器（如 Cursor）。如果您的客户端无法正常工作，请查阅其文档以获取正确的包装器格式。

代理设置（适用于企业网络）

如果您在公司内部运行此服务器——尤其是在公司防火墙或代理之后——您可能需要告知程序如何通过您网络的代理发送互联网流量。请按照以下步骤操作：

1. 获取您的代理详细信息

• 向 IT 部门索取 HTTPS 代理地址和端口。
• 您可能还需要用户名和密码。

2. 设置代理环境变量

对于 Perplexity MCP 来说，最简单可靠的方式是使用 PERPLEXITY_PROXY。例如：

export PERPLEXITY_PROXY=https://your-proxy-host:8080

如果您的代理需要用户名和密码，则使用：

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. 备选方案：标准环境变量

如果您更倾向于使用标准变量，我们支持 HTTPS_PROXY 和 HTTP_PROXY。

[!注意] 服务器会按以下顺序检查代理设置：PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY。如果均未设置，则直接连接到互联网。 URL 必须包含 https://。常见端口为 8080、3128 和 80。

HTTP 服务器部署

对于云或共享部署，以 HTTP 模式运行服务器。

环境变量

变量	描述	默认值
PERPLEXITY_API_KEY	您的 Perplexity API 密钥	必填
PERPLEXITY_BASE_URL	自定义 API 请求基础 URL	https://api.perplexity.ai
PORT	HTTP 服务器端口	8080
BIND_ADDRESS	绑定的网络接口	0.0.0.0
ALLOWED_ORIGINS	CORS 域名（逗号分隔）	*

Docker

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

服务器将可通过 http://localhost:8080/mcp 访问。

故障排除

• API 密钥问题：确保 PERPLEXITY_API_KEY 设置正确。
• 连接错误：检查您的互联网连接和 API 密钥的有效性。
• 找不到工具：确保已安装软件包且命令路径正确。
• 超时错误：对于非常耗时的研究查询，可将 PERPLEXITY_TIMEOUT_MS 设置为更高值。
• 代理问题：验证您的 PERPLEXITY_PROXY 或 HTTPS_PROXY 设置，并确保 api.perplexity.ai 未被您的防火墙阻止。
• EOF / 初始化错误：某些严格的 MCP 客户端会因 npx 将安装消息写入 stdout 而失败。请使用 npx -yq 代替 npx -y 来抑制此输出。

如需支持，请访问 community.perplexity.ai 或 提交问题。

---

Perplexity MCP Server 快速上手指南

Perplexity API Platform 的官方 MCP（Model Context Protocol）服务器实现。它通过 Sonar 模型和搜索 API，为 AI 助手提供实时网络搜索、推理和研究能力。

环境准备

• Node.js：确保已安装 Node.js 环境（推荐最新 LTS 版本），因为该工具通过 npx 运行。
• API Key：你需要一个有效的 Perplexity API Key。
  • 前往 Perplexity API Portal 获取密钥。
• MCP 兼容客户端：支持 Cursor、VS Code、Claude Desktop、Windsurf、Claude Code 或 Codex 等客户端。

安装步骤

1. 获取 API Key

在 Perplexity 官网注册并生成 API Key，后续配置中需替换 `your_key_here为实际密钥。

2. 配置客户端

根据你使用的编辑器或客户端，选择以下一种方式进行配置：

方案 A：一键安装（推荐 Cursor 和 VS Code 用户）

点击 README 顶部的 "Install in Cursor" 或 "Install in VS Code" 徽章即可自动配置。

方案 B：手动配置 JSON 文件

适用于 Cursor、Claude Desktop、Windsurf 等客户端。

• Cursor: 编辑 ~/.cursor/mcp.json
• Claude Desktop: 编辑 claude_desktop_config.json
• Windsurf: 编辑 ~/.codeium/windsurf/mcp_config.json

添加以下配置内容：

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

方案 C：VS Code 手动配置

在项目的 .vscode/mcp.json 文件中添加：

{
  "servers": {
    "perplexity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

方案 D：命令行客户端 (Claude Code / Codex)

Claude Code:

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Codex:

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

注意：如果遇到初始化错误（EOF errors），可能是由于 npx 的输出干扰，尝试将命令中的 npx -y 改为 npx -yq 以抑制额外输出。

基本使用

配置完成后，重启你的 AI 客户端。AI 助手将自动加载以下四个核心工具，你可以通过自然语言直接调用：

1. 实时搜索 (perplexity_search)

   • 用途：查找最新的网络信息和带元数据的排名结果。
   • 示例：“帮我搜索一下今天关于 AI 行业的最新新闻。”

2. 通用问答 (perplexity_ask)

   • 用途：基于 sonar-pro 模型的日常对话和快速查询，结合实时网络搜索。
   • 示例：“解释一下量子计算的基本原理，并结合最新进展。”

3. 深度研究 (perplexity_research)

   • 用途：基于 sonar-deep-research 模型，进行详尽的分析和生成详细报告。
   • 示例：“请对 2024 年电动汽车电池技术的技术路线进行深入研究报告。”

4. 高级推理 (perplexity_reason)

   • 用途：基于 sonar-reasoning-pro 模型，处理复杂的逻辑分析和问题解决。
   • 示例：“分析这段代码的性能瓶颈，并提出优化方案。”

可选参数提示： 在使用 perplexity_reason 和 perplexity_research 时，可以设置 strip_thinking: true 来移除回复中的 <think>...</think> 标签，以节省上下文 Token。