Perplexity Ask MCP Server

官方

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

GitHub
2.5k
試用此 MCP贊助

你可以用 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 用戶端尚不支援遠端伺服器，請跳至下方的本機伺服器設定。透過 Streamable HTTP 使用您的 Perplexity API 金鑰連線：

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

Agent 外掛程式

此儲存庫已封裝為 Agent 外掛程式，因此支援該標準的用戶端可直接從此儲存庫安裝。Agent 外掛程式格式不攜帶機密資訊，因此請透過用戶端的外掛程式或 MCP 設定來設定 PERPLEXITY_API_KEY 環境變數。

其他 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"
      }
    }
  }
}

Proxy 設定（適用於企業網路）

若您在公司環境中執行此伺服器——尤其是位於公司防火牆或 Proxy 後方——您可能需要告知程式如何透過您網路的 Proxy 傳送網際網路流量。請依照以下步驟操作：

1. 取得您的 Proxy 詳細資料

  • 向您的 IT 部門詢問您的 HTTPS Proxy 位址與連接埠。
  • 您可能也需要使用者名稱與密碼。

2. 設定 Proxy 環境變數

對 Perplexity MCP 而言，最簡單且最可靠的方式是使用 PERPLEXITY_PROXY。例如：

export PERPLEXITY_PROXY=https://your-proxy-host:8080

若您的 Proxy 需要使用者名稱與密碼，請使用：

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. 替代方案：標準環境變數

若您偏好使用標準變數，我們支援 HTTPS_PROXY 與 HTTP_PROXY。

[!NOTE] 伺服器依以下順序檢查 Proxy 設定：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要綁定的網路介面。預設為 loopback。設定為 0.0.0.0 以在所有介面上公開。127.0.0.1
ALLOWED_ORIGINSCORS 來源（以逗號分隔）。預設為空（不允許跨來源瀏覽器請求）。設定為明確的允許清單（例如 https://app.example.com）或設定為 * 以允許任何來源。（空）
ALLOWED_HOSTS要接受的其他 Host 標頭值（以逗號分隔）。PORT 上的 Loopback 主機一律允許。綁定至 0.0.0.0 時，請加入公開主機名稱。（僅 loopback）

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）與 Fast Search（search_type: "fast"），可降低延遲與成本。

perplexity_ask

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

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 設定為較高的值
  • Proxy 問題：驗證您的 PERPLEXITY_PROXY 或 HTTPS_PROXY 設定，並確保 api.perplexity.ai 未被您的防火牆封鎖。
  • EOF / 初始化錯誤：某些嚴格的 MCP 用戶端會因為 npx 將安裝訊息寫入 stdout 而失敗。請使用 npx -yq 而非 npx -y 來抑制此輸出。

如需支援，請造訪 community.perplexity.ai 或回報問題。