Perplexity Ask MCP Server

官方

一个用于Perplexity API的连接器，可在MCP生态系统中实现网络搜索功能。

GitHub

2.3k

文档

Perplexity API 平台 MCP 服务器

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

可用工具

perplexity_search

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

perplexity_ask

使用 sonar-pro 模型进行通用对话式 AI 并支持实时网络搜索。非常适合快速提问和日常搜索。

perplexity_research

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

perplexity_reason

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

[!TIP] 作为 perplexity_reason 和 perplexity_research 的可选参数提供：strip_thinking

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

配置

获取您的 API 密钥

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

Claude Code

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
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

Codex

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

Cursor、Claude Desktop、Kiro、Windsurf 和 VS Code

大多数客户端可以在其客户端配置中使用相同的 mcpServers 包装器进行手动配置（如 Cursor 所示）。如果客户端具有不同的架构，请查阅其文档以获取确切的包装器格式。

对于手动设置，这些客户端都使用相同的 mcpServers 结构：

客户端	配置文件
Cursor	`~/.cursor/mcp.json`
Claude Desktop	`claude_desktop_config.json`
Kiro	`.kiro/settings/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
VS Code	`.vscode/mcp.json`

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

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

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

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。

[!NOTE] 服务器按以下顺序检查代理设置：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` 以在所有接口上公开。	`127.0.0.1`
`ALLOWED_ORIGINS`	CORS 来源（逗号分隔）。默认为空（不允许跨域浏览器请求）。设置为显式允许列表（例如 `https://app.example.com`）或设置为 `*` 以允许任何来源。	（空）
`ALLOWED_HOSTS`	要接受的额外 `Host` 标头值（逗号分隔）。`PORT` 上的环回主机始终被允许。绑定到 `0.0.0.0` 时添加公共主机名。	（仅环回）

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 或提交问题。