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 仓库了解更多信息。