Perplexity Chat MCP Server

基本能力

产品定位

Perplexity Chat MCP Server 是一个用于与 Perplexity AI 进行交互的中间件服务，旨在为开发者提供便捷的 API 访问和聊天管理功能。

核心功能

• 模型配置：通过环境变量 PERPLEXITY_MODEL 灵活选择模型，支持为不同工具指定不同模型。
• 持久化聊天历史：chat_perplexity 工具维护完整的聊天上下文，支持继续现有对话。
• 流式响应：使用进度报告防止慢速响应超时。
• Web UI：提供交互式聊天界面和聊天历史管理功能。

适用场景

• 开发者在需要与 Perplexity AI 进行编程辅助、错误调试和技术解释时使用。
• 需要维护长期对话上下文的场景，如研究、调试等。
• 需要本地存储和管理聊天历史的场景。

工具列表

• ask_perplexity：请求 Perplexity 的专家编程帮助，专注于编码解决方案、错误调试和技术解释。
• chat_perplexity：维护与 Perplexity AI 的持续对话，支持创建新聊天或继续现有聊天。
• list_chats_perplexity：列出所有可用的聊天对话，返回聊天 ID、标题和创建时间。
• read_chat_perplexity：检索特定聊天的完整对话历史，仅从本地存储读取。

常见问题解答

• 如何配置模型？：通过环境变量 PERPLEXITY_MODEL、PERPLEXITY_MODEL_ASK 和 PERPLEXITY_MODEL_CHAT 配置。
• 如何启用 Web UI？：设置 WEB_UI_ENABLED=true，默认访问地址为 http://127.0.0.1:8050。
• 聊天数据存储在哪里？：默认存储在 chats.db 文件中，可通过 DB_PATH 环境变量修改路径。

使用教程

使用依赖

• Python 3.10 或更高版本
• uvx 包管理器

安装 uvx 的命令：

curl -Ls https://astral.sh/uv/install.sh | sh

安装教程

1. 创建虚拟环境：

python -m venv .venv
source .venv/bin/activate  # On Linux/macOS
.venv\Scripts\activate  # On Windows

1. 安装项目（可编辑模式）：

pip install -e .

1. 构建项目：

python -m build

调试方式

1. 配置环境变量：

export PERPLEXITY_API_KEY="your-api-key"
export PERPLEXITY_MODEL="sonar-pro"
export DB_PATH="chats.db"

1. 启动服务：

uvx mcp-perplexity

1. 访问 Web UI（如启用）：

http://127.0.0.1:8050

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。