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 模型进行高级推理和问题解决。非常适合复杂的分析任务。

配置

获取您的 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 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 结构：

{
  "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。

HTTP 服务器部署

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

环境变量

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