Perplexity Web Search

🚀 perplexity 網絡搜索 MCP 服務器

這是一個簡單的 MCP（模型上下文協議）服務器，藉助 Perplexity API 實現網絡搜索功能。該服務器能讓 Claude 或其他兼容 MCP 的 AI 助手進行網絡搜索，獲取最新信息。

✨ 主要特性

• 藉助 Perplexity 強大的搜索能力開展網絡搜索。
• 獲取全面的搜索結果，涵蓋來源和引用。
• 可按時間範圍（天、周、月、年）過濾搜索結果。
• 提供現成的網絡搜索提示模板。
• 支持從環境變量或 .env 文件加載 API 密鑰。

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴，可選擇以下任意一種方式：

   pip install -e .
   

   或者

   uv pip install -e .
   

📚 詳細文檔

配置

你可以設置 PERPLEXITY_API_KEY 環境變量，使用你的 Perplexity API 密鑰：

export PERPLEXITY_API_KEY="your-api-key-here"

或者創建項目根目錄中的 .env 文件，包含以下內容：

PERPLEXITY_API_KEY=your-api-key-here

項目提供了一個示例 .env.example 文件供參考。

獲取 Perplexity API 密鑰的步驟如下：

1. 訪問 Perplexity API 設置。
2. 如果沒有賬戶則創建一個。
3. 生成 API 密鑰。

使用方法

運行服務器

python server.py

測試服務器功能

可以使用包含的測試腳本在不運行完整的 MCP 服務器的情況下測試服務器功能：

python test_server.py "your search query here" --recency month

--recency 的選項有：day, week, month (默認), year

集成到 Claude Desktop 中

1. 編輯你的 Claude Desktop 配置文件：
   • 在 macOS 上：~/Library/Application\ 支持/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json
2. 添加以下配置：

   {
     "perplexity-mcp": {
       "env": {
         "PERPLEXITY_API_KEY": "your-api-key-here"
       },
       "command": "python",
       "args": [
         "/path/to/server.py"
       ]
     }
   }
   

3. 重啟 Claude Desktop

示例提示語（供 Claude 使用）

• “搜索有關人工智能最新新聞的網絡信息”
• “使用 Perplexity 查找過去一週關於氣候變化的信息”
• “搜索過去一個月量子計算方面的最新研究論文”

📄 API 文檔

工具：search_web(query: str, recency: str = "month") -> str

使用 Perplexity API 搜索網絡並返回結果。

參數：

• query：搜索查詢字符串。
• recency：按時間段過濾結果 - 'day', 'week', 'month' (默認), 或 'year'。

返回值： 一個全面的文本響應，包含：

1. 搜索結果的詳細摘要。
2. 關鍵事實和信息。
3. 來源 URL 用於驗證。
4. 如果有的話，任何衝突的信息。

提示語：web_search_prompt(query: str, recency: str = "month") -> str

創建一個提示模板，用於使用 Perplexity 進行網絡搜索。

參數：

• query：搜索查詢。
• recency：時間範圍過濾器 - 'day', 'week', 'month' (默認), 或 'year'。

返回值： 一個格式化的提示字符串，指示 AI：

1. 搜索指定的查詢。
2. 焦點在指定的時間段內的結果上。
3. 總結關鍵發現。
4. 指出信息的重要性。
5. 提供具體細節。