Perplexity Ask MCP Server

官方

一個用於 Perplexity API 的連接器，可在 MCP 生態系統中啟用網路搜尋功能。

GitHub
2.4k

你可以用 Perplexity Ask MCP 做什麼？

  • 即時搜尋網路 — 使用 perplexity_search 詢問最新資訊，可依時間範圍或網域進行篩選。
  • 透過即時搜尋快速取得答案 — 使用 perplexity_ask 獲得快速、對話式的回覆，並有網路結果作為依據。
  • 進行深度研究 — 使用 perplexity_research 要求詳盡、多步驟的分析與詳細報告。
  • 解決複雜的推理任務 — 使用 perplexity_reason 處理分析性問題，進行進階的逐步推理。

文件

Perplexity API 平台 MCP 伺服器

Install in Cursor   Install in VS Code   Add to Kiro   npm version

Perplexity API 平台的官方 MCP 伺服器實作，透過 Agent API 和 Search API 為 AI 助理提供即時網路搜尋、推理和研究能力。

遠端 MCP 伺服器

遠端 MCP 伺服器由 Perplexity 託管，是最簡單的入門方式：相同的工具，無需安裝或更新。本頁頂部的 Cursor 和 VS Code 按鈕可一鍵連線。如果您的 MCP 用戶端尚不支援遠端伺服器，請跳至下方的本機伺服器設定。使用您的 Perplexity API 金鑰透過 Streamable HTTP 連線：

https://api.perplexity.ai/mcp

適用於 Claude Code：

claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

有關手動設定 Cursor/VS Code、從 Anthropic API 使用以及其他用戶端的設定，請參閱 MCP 整合文件。

本機 MCP 伺服器

取得您的 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

其他 MCP 用戶端

大多數用戶端可以在其用戶端設定中使用相同的 mcpServers 包裝器進行手動設定（如 Cursor 所示）。如果用戶端有不同的架構，請查閱其文件以取得確切的包裝器格式。

對於手動設定，這些用戶端都使用相同的 mcpServers 結構：

用戶端設定檔
Cursor~/.cursor/mcp.json
Claude Desktopclaude_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_URLAPI 請求的自訂基礎 URLhttps://api.perplexity.ai
PORTHTTP 伺服器連接埠8080
BIND_ADDRESS要綁定的網路介面。預設為迴路。設定為 0.0.0.0 以在所有介面上公開。127.0.0.1
ALLOWED_ORIGINSCORS 來源（以逗號分隔）。預設為空（無跨來源瀏覽器請求）。設定為明確的允許清單（例如 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 存取

可用工具

perplexity_search

使用 Perplexity Search API 進行直接網路搜尋。傳回帶有中繼資料的排名搜尋結果，非常適合尋找最新資訊。支援時效性篩選器 (search_recency_filter) 和網域限制 (search_domain_filter)。

perplexity_ask

由 Agent API fast 預設集支援的通用對話式 AI，具備即時網路搜尋功能。非常適合快速問題和日常搜尋。

perplexity_research

由 Agent API high 預設集支援的深入、全面研究。非常適合徹底分析和詳細報告。執行可能需要幾分鐘；伺服器會串流執行過程，並向請求的用戶端回報進度。

perplexity_reason

由 Agent API medium 預設集支援的進階推理和問題解決。非常適合複雜的分析任務。

[!NOTE] 預設集是 Perplexity 持續調整的受管理設定（模型、搜尋設定、步驟預算）；請參閱預設集指南。此伺服器的早期版本會呼叫舊版的 sonar-pro、sonar-reasoning-pro 和 sonar-deep-research 模型，並接受 strip_thinking / reasoning_effort 參數。這些參數不再是工具架構的一部分，若傳送也會被忽略；Agent API 不會產生 <think> 標籤。

作為函式庫使用

此套件也匯出伺服器工廠函式，以便嵌入到您自己的 Node 程序中：

import { createPerplexityServer } from "@perplexity-ai/mcp-server";

// Single-tenant: reads PERPLEXITY_API_KEY from the environment.
const server = createPerplexityServer("my-service");

// Multi-tenant hosts resolve the key per call instead. When a provider is
// set, the environment variable is never consulted, and a provider that
// returns no key fails the call rather than falling back.
const tenantServer = createPerplexityServer("my-service", {
  apiKey: () => currentRequestApiKey,
});

將傳回的伺服器掛載到任何 MCP 傳輸上（stdio、streamable HTTP、記憶體內）。

疑難排解

  • 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 或提交問題。