Perplexity

官方

一個連接到

GitHub
2.4k

你可以用 Perplexity MCP 做什麼？

  • 即時網路搜尋 — 透過 perplexity_search 詢問最新資訊，可選用時效篩選與網域限制。
  • 附即時來源的快速問答 — 使用 perplexity_ask 取得結合即時網路搜尋的對話式回答。
  • 深度研究報告 — 透過 perplexity_research 請求詳盡的多步驟分析，該工具會為長時間任務串流傳輸進度。
  • 複雜推理任務 — 運用 perplexity_reason 處理進階問題解決與分析工作。
  • 自訂部署選項 — 可在本機、透過 Docker 或作為自架 HTTP 服務執行伺服器，並可設定代理與安全選項。

文件

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"

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

本機 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"
      }
    }
  }
}

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）。

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 或回報問題。