适合谁
- 需要实时网页搜索的 AI 助手
- 需要 Perplexity Agent API 研究和推理能力的用户
- 使用支持 MCP 配置的开发者工具的用户
P
64FMRS · C
官方 Perplexity MCP Server，提供四个面向实时搜索、问答、深度研究和高级推理的工具；需要 Perplexity API 密钥和网络访问，默认使用 stdio。
Perplexity API Platform 的官方 MCP Server 实现，通过 Agent API 和 Search API 为 AI 助手提供实时网页搜索、推理和研究能力。服务器通过 stdio 运行，npm 包为 @perplexity-ai/mcp-server 1.2.0。
工具能力
perplexity_search
使用 Perplexity Search API 直接进行网页搜索，返回带元数据的排序结果，并支持时效和域名过滤。
perplexity_ask
基于 Agent API fast preset 的通用对话式 AI，支持实时网页搜索，适合快速提问和日常搜索。
perplexity_research
基于 Agent API high preset 的深度研究工具，适合全面分析和详细报告；运行可能需要数分钟。
perplexity_reason
基于 Agent API medium preset 的高级推理与问题解决工具，适合复杂分析任务。
安装接入
先从 Perplexity API Portal 获取 API 密钥，然后将 PERPLEXITY_API_KEY 设置为该密钥，并使用提供的客户端配置运行 npx -y @perplexity-ai/mcp-server。长时间研究任务可设置 PERPLEXITY_TIMEOUT_MS；企业网络可配置 PERPLEXITY_PROXY、HTTPS_PROXY 或 HTTP_PROXY。
claude_desktop_config.json
{"mcpServers":{"perplexity":{"command":"npx","args":["-y","@perplexity-ai/mcp-server"],"env":{"PERPLEXITY_API_KEY":"your_key_here"}}}}
选型与风险
不适合谁
- 不需要联网或外部 API 的本地任务
- 无法提供 Perplexity API 密钥的环境
- 不适合等待数分钟研究运行的即时场景
所需权限
- 需要访问 PERPLEXITY_API_KEY
- 需要连接 Perplexity API 和互联网
- HTTP 部署时可能需要监听网络接口并配置主机、来源和端口
风险与副作用
- API 密钥需要通过环境变量配置，应避免泄露。
- 将 BIND_ADDRESS 设置为 0.0.0.0 会对所有网络接口暴露 HTTP 服务。
- 将 ALLOWED_ORIGINS 设置为 * 会允许任意来源的跨域浏览器请求。
- 深度研究运行可能耗时数分钟，并可能需要提高超时时间。
常见排障
- 确认 PERPLEXITY_API_KEY 已正确设置且有效。
- 检查网络连接以及防火墙或代理是否允许访问 api.perplexity.ai。
- 确认 npm 包已安装且命令路径正确。
- 长时间研究任务可提高 PERPLEXITY_TIMEOUT_MS。
- 若客户端出现 EOF 或 Initialize 错误，可使用 npx -yq 抑制安装信息输出。
使用场景
查找当前网页信息
进行快速问答和日常搜索
生成深度研究报告
处理复杂分析与推理任务
支持客户端
Claude Code完整支持
Codex完整支持
Cursor完整支持
Claude Desktop完整支持
Kiro完整支持
Windsurf完整支持
VS Code完整支持