← 返回目录

Perplexity API Platform

官方

通过 Perplexity API 实时搜索、推理与研究。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 42 / 230
Stars: ★ 2.6k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 10 天前
工具数: 4

64FMRS · C

官方 Perplexity MCP Server，提供四个面向实时搜索、问答、深度研究和高级推理的工具；需要 Perplexity API 密钥和网络访问，默认使用 stdio。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

13/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 清单声明了 npm stdio 包和 1.2.0 版本，README 列出了四个工具及基本行为，表明正常初始化路径是合理的。但仅有清单和 README，没有可核验的源码、CI 或提交测试来证明 MCP 初始化、工具列表握手、错误处理、超时和依赖行为，因此按静态审查扣分，不能超过 12 分。
安全与权限 12/20: API 密钥通过环境变量传入，未见示例中包含真实密钥；默认 HTTP 绑定回环地址，并提供来源和主机限制，体现了一定的权限边界。扣分原因是工具会访问外部搜索/API，文档未充分说明查询数据边界、隐私、费用控制或请求确认；同时支持自定义基础 URL 和代理，扩大了网络信任范围。未发现触发安全红线的证据。
维护活跃度 13/20: 仓库标为未归档，具有 MIT 许可证，且提供官方包名和明确版本，显示出可识别的维护归属。扣分原因是给定材料没有提交频率、发布历史、依赖更新、问题响应、漏洞披露或安全响应渠道的可核验信息；星标和开放问题数量不计入评分。
文档质量 15/20: README 覆盖了安装方式、API 密钥配置、四个工具用途、多客户端示例、代理、HTTP 部署、库使用方式和故障排查，整体可操作性较强。扣分原因是缺少可审查的工具参数模式、返回结构、速率/上下文/超时限制、成本说明和权限/数据处理说明；主要证据是 README，缺少源码或测试交叉验证。
安装易用性 14/20: 提供了 npx 一步式安装命令、stdio 配置、多个主流客户端示例，以及 API 密钥和常见故障说明，连接路径相对清晰。扣分原因是依赖 Node/npm 和有效 API 密钥，npx stdout 问题需要额外调整，HTTP/代理部署更复杂；材料没有 CI 或提交测试来验证安装和握手，因此按静态校准不超过 15 分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要实时网页搜索的 AI 助手
需要 Perplexity Agent API 研究和推理能力的用户
使用支持 MCP 配置的开发者工具的用户

不适合谁

不需要联网或外部 API 的本地任务
无法提供 Perplexity API 密钥的环境
不适合等待数分钟研究运行的即时场景

所需权限

需要访问 PERPLEXITY_API_KEY
需要连接 Perplexity API 和互联网
HTTP 部署时可能需要监听网络接口并配置主机、来源和端口

风险与副作用

API 密钥需要通过环境变量配置，应避免泄露。
将 BIND_ADDRESS 设置为 0.0.0.0 会对所有网络接口暴露 HTTP 服务。
将 ALLOWED_ORIGINS 设置为 * 会允许任意来源的跨域浏览器请求。
深度研究运行可能耗时数分钟，并可能需要提高超时时间。

安装接入

准备工作

运行环境：Node.js · Docker

PERPLEXITY_API_KEY 必填密钥 Perplexity API 密钥，必需，在 Perplexity API 门户（perplexity.ai/account/api/group）获取

其他可选配置项（10 个）

PERPLEXITY_TIMEOUT_MS 可选可选的 API 请求超时时间（毫秒），默认 5 分钟，长研究任务可调高

PERPLEXITY_BASE_URL 可选可选的自定义 API 基础地址，默认 https://api.perplexity.ai

PERPLEXITY_LOG_LEVEL 可选可选的日志级别，可设为 DEBUG|INFO|WARN|ERROR，默认 ERROR

PERPLEXITY_PROXY 可选可选的企业代理地址（需含 https://），支持用户名密码形式

HTTPS_PROXY 可选可选的标准 HTTPS 代理变量，优先级低于 PERPLEXITY_PROXY

HTTP_PROXY 可选可选的标准 HTTP 代理变量，优先级最低

PORT 可选 HTTP 模式下的服务端口，默认 8080

BIND_ADDRESS 可选 HTTP 模式的绑定网络接口，默认 127.0.0.1，设为 0.0.0.0 暴露到所有接口

ALLOWED_ORIGINS 可选 HTTP 模式的 CORS 允许来源，逗号分隔，默认为空（禁止跨域浏览器请求）

ALLOWED_HOSTS 可选 HTTP 模式额外允许的 Host 头值，绑定 0.0.0.0 时需添加公开主机名

先从 Perplexity API Portal 获取 API 密钥，然后将 PERPLEXITY_API_KEY 设置为该密钥，并使用提供的客户端配置运行 npx -y @perplexity-ai/mcp-server。长时间研究任务可设置 PERPLEXITY_TIMEOUT_MS；企业网络可配置 PERPLEXITY_PROXY、HTTPS_PROXY 或 HTTP_PROXY。

.mcp.json

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

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置好 PERPLEXITY_API_KEY 并启动后，工具列表中应出现 perplexity_search、perplexity_ask、perplexity_research、perplexity_reason 四个工具；调用 perplexity_ask 提问一个时事问题，若能返回带搜索来源的回答即说明连接正常。

常见排障

确认 PERPLEXITY_API_KEY 已正确设置且有效。
检查网络连接以及防火墙或代理是否允许访问 api.perplexity.ai。
确认 npm 包已安装且命令路径正确。
长时间研究任务可提高 PERPLEXITY_TIMEOUT_MS。
若客户端出现 EOF 或 Initialize 错误，可使用 npx -yq 抑制安装信息输出。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 perplexity_search 搜索最新的 AI 新闻，只保留最近一周的结果
用 perplexity_ask 问一下今天的比特币价格是多少
用 perplexity_research 写一份关于固态电池技术现状的详细报告
用 perplexity_reason 分析为什么我的分布式系统会出现一致性问题

工具能力 4

perplexity_search 只读

使用 Perplexity Search API 直接进行网页搜索，返回带元数据的排序结果，并支持时效和域名过滤。

perplexity_ask 只读

基于 Agent API fast preset 的通用对话式 AI，支持实时网页搜索，适合快速提问和日常搜索。

perplexity_research 只读

基于 Agent API high preset 的深度研究工具，适合全面分析和详细报告；运行可能需要数分钟。

perplexity_reason 只读

基于 Agent API medium preset 的高级推理与问题解决工具，适合复杂分析任务。

使用场景

查找当前网页信息

进行快速问答和日常搜索

生成深度研究报告

处理复杂分析与推理任务

支持客户端

Claude Code

Codex

Cursor

Claude Desktop

Kiro

Windsurf

VS Code

依据项目文档列出，未经本站实测。

详细介绍

Perplexity API Platform 的官方 MCP Server 实现，通过 Agent API 和 Search API 为 AI 助手提供实时网页搜索、推理和研究能力。服务器通过 stdio 运行，npm 包为 @perplexity-ai/mcp-server 1.2.0。