MCP Perplexity

🚀 項目簡介

本項目旨在解決開發過程中的常見問題，提供了一系列功能強大的工具，助力開發者更高效地完成任務。

🚀 快速開始

安裝步驟

1. 創建虛擬環境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Linux/macOS 上運行
   # 或者在 Windows 上運行
   .venv\Scripts\activate
   

2. 安裝項目：

   pip install -e .
   

3. 構建項目：

   python -m build
   

環境變量配置

以下是所有支持的環境變量及其默認值：

✨ 主要特性

• 維護對話歷史：支持持續對話，每個對話都有唯一 ID。
• 分頁顯示對話列表：方便管理大量對話記錄。
• 即時消息顯示：通過 Web UI 提供直觀的聊天界面。
• 本地數據庫訪問：無需網絡即可讀取對話歷史。

📦 安裝指南

安裝步驟

1. 創建虛擬環境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Linux/macOS 上運行
   # 或者在 Windows 上運行
   .venv\Scripts\activate
   

2. 安裝項目：

   pip install -e .
   

3. 構建項目：

   python -m build
   

💻 使用示例

命令行使用

npx -y @smithery/cli@latest run @daniel-lxs/mcp-perplexity --config "{\"perplexityApiKey\":\"pplx-abc\",\"perplexityModel\":\"sonar-pro\"}"

📚 詳細文檔

組件

工具介紹

ask_perplexity

ask_perplexity 工具用於回答具體的問題，每個請求都會被視為一個新的對話。該工具會使用 PERPLEXITY_MODEL_ASK 模型（如果指定）或默認的 PERPLEXITY_MODEL 模型來生成響應。

chat_perplexity

chat_perplexity 工具用於維護持續的對話歷史記錄。每個對話都有一個唯一的 ID，該 ID 在創建新對話時返回。你可以通過提供 page 參數（默認為 1）來指定要查看的頁碼（每頁顯示 50 條記錄）。

list_chats_perplexity

list_chats_perplexity 工具用於列出所有可用的對話記錄。它會以分頁形式返回對話列表，顯示每個對話的 ID、標題和創建時間（相對格式）。默認情況下，每頁顯示 50 條記錄。

read_chat_perplexity

read_chat_perplexity 工具用於檢索指定 chat_id 的完整對話歷史記錄。該工具會返回所有消息，包括時間和角色信息。此工具不會向 Perplexity 發起任何 API 請求，僅從本地數據庫讀取數據。

Web UI

功能特點

• 交互式聊天界面：提供直觀的對話體驗。
• 聊天曆史管理：方便查看和操作所有對話記錄。
• 即時消息顯示：支持即時消息更新。

訪問方式

當 WEB_UI_ENABLED 設為 true 時，Web UI 將可通過地址 http://WEB_UI_HOST:WEB_UI_PORT 訪問，默認為 http://localhost:8080。

開發指南

• 代碼結構：項目採用模塊化設計，便於擴展和維護。
• 日誌系統：集成詳細日誌記錄，幫助調試和監控。

貢獻指南

歡迎貢獻！請參考項目的 GitHub 倉庫瞭解更多信息。