Perplexity Ask MCP Server

Perplexity API 平台 MCP 伺服器

     

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

可用工具

perplexity_search

使用 Perplexity 搜尋 API 進行直接網路搜尋。傳回帶有中繼資料的排序搜尋結果，非常適合尋找最新資訊。

perplexity_ask

使用 sonar-pro 模型，具備即時網路搜尋功能的通用對話式 AI。非常適合快速提問和日常搜尋。

perplexity_research

使用 sonar-deep-research 模型進行深入、全面的研究。非常適合徹底分析和詳細報告。

perplexity_reason

使用 sonar-reasoning-pro 模型進行進階推理和問題解決。非常適合複雜的分析任務。

[!TIP] 可作為 perplexity_reason 和 perplexity_research 的選用參數：strip_thinking

設定為 true 可從回應中移除 <think>...</think> 標籤，以節省上下文 token。預設值：false

設定

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

Cursor、Claude Desktop、Kiro、Windsurf 和 VS Code

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

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

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

疑難排解

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

---