Perplexity Insight

🚀 perplexity-insight-MCP服務端

一個用於與Perplexity AI接口交互的MCP服務器實現，通過標準化模型上下文協議（Model Context Protocol），為用戶提供高級問題解答能力。

🚀 快速開始

本項目是一個與Perplexity AI接口交互的MCP服務器，能借助標準化模型上下文協議實現高級問題解答。以下是快速開啟使用的步驟：

1. 完成安裝要求，確保具備Node.js 18+和Perplexity API密鑰。
2. 按照安裝步驟執行npm install完成依賴安裝。
3. 創建.env文件並配置PERPLEXITY_API_KEY。
4. 運行npm start啟動服務器。

✨ 主要特性

• 無縫集成：與Perplexity AI API無縫集成。
• 多模型支持：支持不同的Perplexity模型，如sonar-reasoning、sonar-pro、sonar-deep-research。
• 可定製性：可定製系統提示和用戶查詢。
• 錯誤處理：具備正確的錯誤處理和響應格式化機制。
• 速率保護：有防止速率限制的保護措施。
• 輕鬆集成：可與Windsurf IDE輕鬆集成。

📦 安裝指南

安裝要求

• Node.js 18+
• Perplexity API密鑰

安裝步驟

執行以下命令安裝依賴：

npm install

環境變量配置

創建一個.env文件，包含以下變量：

PERPLEXITY_API_KEY=your_api_key_here

💻 使用示例

基礎用法

運行服務器：

npm start

高級用法

API工具使用

服務器公開了以下工具：

1. perplexity_ask - 直接向Perplexity AI發送問題。
2. perplexity_search - 使用Perplexity AI執行搜索查詢。

更改模型

兩個工具都支持Perplexity的以下模型：

• sonar-reasoning（默認）- Perplexity的推理焦點模型，最適合通用問題。
• sonar-pro - 增強型模型，改進了專業用例的能力。
• sonar-deep-research - 專門用於深入研究和複雜查詢。

在使用工具時指定模型，請在請求中包含model參數：

使用 sonar-deep-research詢問Perplexity：量子計算的最新進展是什麼？

您還可以自定義系統提示和最大令牌數：

使用 sonar-pro 通過 Perplexity 搜索，系統提示為 "You are a helpful research assistant"，最大令牌數為2000：可再生能源的最新發展

工具響應格式

服務器遵循MCP規範的工具響應格式：

{
  content: [
    {
      type: "text",
      text: "Perplexity AI的回答內容"
    }
  ],
  isError: false // 或true如果發生錯誤
}

📚 詳細文檔

Windsurf集成

在Windsurf中設置

1. 構建服務器：

   npm run build
   

2. 打開Windsurf並導航到設置。
3. 找到“AI設置”或“模型上下文協議”部分。
4. 添加一個新的MCP服務器，使用以下詳細信息：
   • 名稱：Perplexity Insight
   • 類型：本地進程
   • 命令：指向您的Node.js可執行文件的路徑
   • 參數：指向您編譯的index.js文件的路徑
   • 工作目錄：指向您的項目目錄
   • 環境變量：確保包含PERPLEXITY_API_KEY=your_api_key_here
5. 啟用服務器並根據需要重啟Windsurf。

示例配置

以下是mcp_config.json文件示例配置：

"perplexity-ask": {
  "command": 指向Node.js可執行文件的路徑,
  "args": [
    "node",
    "index.js"
  ],
  "env": {
    "PERPLEXITY_API_KEY": "your_api_key_here"
  }
}

故障排除

• 問題：無法連接到Perplexity API
  解決方法：檢查API密鑰是否正確，並確保互聯網連接正常。

開發

若要進行開發，可執行以下命令：

npm run dev

📄 許可證

本項目採用MIT許可證。