perplexity-mcp-server

MCP 服务器，用于基于 Perplexity Sonar API 的结构化竞争/市场情报监测工作流。

更正（2026-08-26）： 本 README 的早期版本曾声称任何地方都不存在原生的 Perplexity MCP 连接器。那是错误的——Perplexity 发布了一个官方 MCP 服务器（github.com/perplexityai/modelcontextprotocol），包括一个由 Perplexity 托管的远程端点 https://api.perplexity.ai/mcp，可从云端定时会话访问，且完全无需自托管。如果你只是需要通用的临时 Sonar 搜索，请注册该服务器，而不是在这里构建或运行任何东西。

官方服务器不能提供的是结构化、可比较的每周监测输出：它只暴露通用的搜索/推理（Agent API、Search API），而不是固定版块的公司简报或受 JSON schema 约束的信号扫描。这才是本服务器存在的真正原因——它是一个由两个工作流工具构成的薄而窄的层，而不是 Perplexity 自家 MCP 服务器的替代品。

只需部署一次（见下文“远程部署”），并将 PERPLEXITY_API_KEY 设置为平台密钥，任何 MCP 客户端——包括云端定时 Cowork/Claude 会话——都可以通过 HTTP 调用它，而无需接触本地机器或设备桥接。请将它与 Perplexity 的官方服务器一起注册，而不是替代它。

工具

• perplexity_company_news — 结构化公司新闻简报（gouvernance、dirigeants、événements stratégiques、situation financière、mouvements RH），固定版块标题，使用 lookback_days 而不是自由文本日期范围。

• perplexity_market_signals — 全行业信号扫描（M&A、融资、人事任命、重组），在服务端受 JSON schema 约束，因此结果是离散信号的真实数组，而不是需要重新解析的 markdown。当在所查期间内找不到任何有日期且可靠的信息时，返回空数组（而不是错误）——这是一个有意义的结果，而不是失败。

这两个工具都支持 response_format: "markdown" | "json"，并返回引用/来源。对于通用搜索，请使用 Perplexity 的官方 MCP 服务器——见上文更正。

Related MCP server: Stelar Signals MCP

设置

npm install
cp .env.example .env   # then set PERPLEXITY_API_KEY
npm run build

本地使用（stdio）——快速上手，不能解决云端定时问题

适合测试，或适合任何已经在你自己的机器上运行的工作流。在你 MCP 客户端的配置中注册它（例如 Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["/absolute/path/to/perplexity-mcp-server/dist/index.js"],
      "env": { "PERPLEXITY_API_KEY": "pplx-..." }
    }
  }
}

这仍然将可用性与那台机器是否开启绑定在一起——它不能解决云端定时任务需要密钥这一原始问题。要解决该问题，请使用下面的 HTTP 部署。

远程部署（streamable HTTP）——云端定时任务的实际解决方案

在任何支持 Node 的主机（小型 VPS、Render、Railway、Fly.io，或任意云提供商的容器）上，用 TRANSPORT=http 运行同样的代码。唯一的要求是：Node 18+、能够设置环境变量密钥，以及一个公共 HTTPS URL。

PERPLEXITY_API_KEY=pplx-... TRANSPORT=http PORT=3000 npm start

该服务器暴露：

• POST /mcp — MCP 端点（streamable HTTP、无状态 JSON——每个请求都有全新的服务器+传输，因此调用之间不会泄漏任何数据，并且可以在没有共享状态的情况下水平扩展）

• GET /health — 用于你的托管平台健康检查的简单存活探针

一旦部署到 HTTPS 之后（https://your-host/mcp），请将该 URL 注册为工作区中的远程 MCP 连接器，以便依赖于 Perplexity 的定时任务可以直接访问它，而密钥仅存在于服务端——这与 Pappers 已经使用的运营模式相同（原生连接器，凭据路径中没有本地密钥）。

本次构建中已验证的内容

• npm run build 可干净地编译（严格 TypeScript，无 any）。

• 两种传输方式（stdio 和 HTTP）都能启动且不会崩溃。

• GET /health 响应正确。

• 完整的 MCP 握手（initialize、tools/list）返回两个工具，并带有正确的 JSON schema、描述和注解。

• 使用无效 API 密钥调用 tools/call 会返回清晰、可操作的 isError: true 结果（401 提示指向 Perplexity 仪表盘）——服务器不会崩溃，并且之后仍保持响应。

尚未验证的内容

构建环境中没有可用的真实 PERPLEXITY_API_KEY，因此一次真正成功的 Sonar 调用——真实的回答内容、真实的引用、market_signals 受 JSON schema 约束的响应确实能被解析为有效 JSON——尚未经过端到端验证。在生产环境监测流程中依赖此功能之前，请使用真实密钥各运行一次这两个工具（通过 stdio 在本地运行足以完成此检查），并确认输出与上文记录的形态相符。

成本说明

perplexity_company_news 和 perplexity_market_signals 都默认使用 sonar-pro 模型（比 sonar 搜索更深、来源更多、单次调用成本更高），因为监测用例优先考虑完整性和引用质量，而非延迟/成本——这是本服务器这两个工具刻意为之的默认设置，已于 2026-08-26 确认。这里没有 perplexity_search 工具可供一次性查询选择更便宜的模型；如需该功能，请使用 Perplexity 的官方 MCP 服务器（见本文件顶部的更正）。在每周例行规模下对数以十计的公司运行之前，请先查看 Perplexity 当前的按模型定价——完整运行会处理大约 50-90 家公司，外加一次市场信号扫描，因此 sonar-pro 与 sonar 之间的边际成本会迅速累积。