关键词

perplexity apillm tools编程助手搜索引擎对话

Perplexity MCP Server 使用说明

项目简介

Perplexity MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它将 Perplexity AI 的强大功能集成到 MCP 生态系统中。通过该服务器，你可以利用 'ask_perplexity' 工具获取专业的编程帮助，或使用 'chat_perplexity' 工具与 Perplexity AI 进行持续对话。它旨在为 MCP 客户端提供便捷的方式来访问 Perplexity API 的功能，并将其融入到更广泛的 LLM 应用场景中。

主要功能点

  • ask_perplexity 工具: 提供专业的编程辅助，专注于代码解决方案、错误调试和技术解释。返回带有来源引文和备选建议的回复。
  • chat_perplexity 工具: 与 Perplexity AI 维护持续对话。可以创建新的对话或继续现有的对话，保留完整的历史上下文，并返回 chat ID 以便后续继续对话。
  • 模型配置灵活性: 允许通过环境变量 'PERPLEXITY_MODEL' 灵活指定 Perplexity 模型。同时支持为 'ask_perplexity' 和 'chat_perplexity' 工具分别配置模型 ('PERPLEXITY_MODEL_ASK' 和 'PERPLEXITY_MODEL_CHAT')，以满足不同的需求。
  • 持久化聊天记录: 'chat_perplexity' 工具支持持久化聊天记录，使用 SQLite 数据库存储，方便用户管理和回顾之前的对话。
  • 流式响应与进度报告: 支持流式响应，并使用进度报告机制，避免因响应缓慢导致超时。

安装步骤

  1. 安装 Python 3.10+: 确保你的系统已安装 Python 3.10 或更高版本。
  2. 安装 uvx (推荐): uvx 是一个高性能的 Python 包安装和运行工具，推荐使用以获得更好的性能。你可以根据 README.md 中的指引安装 uvx。
  3. 配置 MCP 客户端: 根据你的 MCP 客户端的配置方法，添加 Perplexity MCP Server 的配置信息。

服务器配置

以下是 MCP 客户端配置 Perplexity MCP Server 的 JSON 示例。你需要将此配置添加到你的 MCP 客户端的服务器列表中。

{
  "mcpServers": {
    "mcp-perplexity": {
      "command": "uvx",
      "args": [
        "mcp-perplexity"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your-perplexity-api-key",
        "PERPLEXITY_MODEL": "sonar-pro",
        "PERPLEXITY_MODEL_ASK": "sonar-pro",
        "PERPLEXITY_MODEL_CHAT": "sonar-reasoning-pro",
        "DB_PATH": "path/to/custom.db"
      }
    }
  }
}

配置参数说明:

  • server name: 'mcp-perplexity' (服务器名称，用于在 MCP 客户端中标识和引用)
  • command: 'uvx' (启动服务器的命令，这里使用 uvx 运行 mcp-perplexity)
  • args: '["mcp-perplexity"]' (传递给启动命令的参数，这里指定运行 mcp-perplexity)
  • env: 环境变量配置，包含以下键值对：
    • PERPLEXITY_API_KEY: 你的 Perplexity API 密钥，请务必替换为你的真实密钥。
    • PERPLEXITY_MODEL: 默认的 Perplexity 模型，用于 'ask_perplexity' 和 'chat_perplexity' 工具，如果未分别指定模型。
    • PERPLEXITY_MODEL_ASK: 'ask_perplexity' 工具使用的 Perplexity 模型，如果设置，将覆盖 'PERPLEXITY_MODEL' 的设置。
    • PERPLEXITY_MODEL_CHAT: 'chat_perplexity' 工具使用的 Perplexity 模型，如果设置，将覆盖 'PERPLEXITY_MODEL' 的设置。
    • DB_PATH: SQLite 数据库文件路径，用于存储聊天记录。默认为 'chats.db'。你可以自定义数据库文件路径。

基本使用方法

  1. 确保你已正确安装 Python, uvx 并配置好 MCP 客户端。
  2. 启动你的 MCP 客户端，客户端将自动连接到 Perplexity MCP Server。
  3. 在 MCP 客户端中，你可以使用以下工具：
    • ask_perplexity: 用于向 Perplexity 提问编程相关问题。你需要提供 'query' 参数，即你的技术问题。
    • chat_perplexity: 用于与 Perplexity AI 进行对话。你需要提供 'message' 参数，即你要发送的消息。如果需要继续之前的对话，可以提供 'chat_id' 参数。你还可以使用 'title' 参数为新的对话指定标题。

示例使用场景:

  • 在 MCP 客户端中，调用 'ask_perplexity' 工具，输入问题 "Python 中如何使用装饰器？"，即可获得 Perplexity AI 提供的关于 Python 装饰器的详细解答和代码示例。
  • 使用 'chat_perplexity' 工具，可以与 Perplexity AI 进行多轮对话，例如先提问 "什么是 Docker？"，然后追问 "Docker 的优势是什么？"，服务器会维护对话历史，提供更连贯的对话体验。

通过 Perplexity MCP Server，你可以方便地在 MCP 客户端中使用 Perplexity AI 的强大功能，提升你的编程效率和问题解决能力。

信息

分类

AI与计算

访问项目