关键词

网页搜索信息检索Perplexity AI工具调用LLM客户端

Perplexity MCP 服务器

本项目 'perplexity-mcp' 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为 LLM 客户端（如 Anthropic Claude Desktop）提供网页搜索能力。它利用 Perplexity AI 的强大搜索 API，让 LLM 能够方便地检索最新的网络信息。

主要功能点

  • 网页搜索工具 (Tool): 提供 'perplexity_search_web' 工具，允许 LLM 通过 Perplexity AI 进行网页搜索。
  • 可配置搜索参数: 支持通过 'query' 参数指定搜索关键词，并通过 'recency' 参数筛选搜索结果的时间范围（如最近一天、一周、一月、一年）。
  • Prompt 模板 (Prompt): 内置 'perplexity_search_web' Prompt 模板，方便用户构建网页搜索相关的 Prompt。
  • 兼容 MCP 协议: 遵循 MCP 协议标准，能够与任何支持 MCP 协议的 LLM 客户端进行通信。
  • 易于安装和配置: 提供通过 Smithery 自动安装以及手动安装方式，支持环境变量配置 API 密钥和模型。

安装步骤

  1. 安装 UV (Python 包管理器): 如果您的系统尚未安装 UV，请根据您的操作系统执行以下命令安装 UV。

    • macOS (Homebrew): 'brew install uv'
    • macOS 和 Linux (curl): 'curl -LsSf https://astral.sh/uv/install.sh | sh'
    • Windows (PowerShell): 'powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"'

  2. 安装 perplexity-mcp 服务器: 使用 UV 安装 'perplexity-mcp' 包。

    • 从 PyPi 安装: 'uv pip install perplexity-mcp'
    • 从源代码安装: 'uv pip install git+https://github.com/jsonallen/perplexity-mcp.git'

  3. 配置环境变量: 您需要设置 Perplexity AI 的 API 密钥作为环境变量。

    • 获取 API 密钥: 访问 Perplexity 官网获取 API 密钥。
    • 设置环境变量 'PERPLEXITY_API_KEY': 将您的 API 密钥设置为名为 'PERPLEXITY_API_KEY' 的环境变量。
      • (可选) 设置环境变量 'PERPLEXITY_MODEL': 您可以选择设置 'PERPLEXITY_MODEL' 环境变量来指定使用的 Perplexity 模型。 默认模型为 '"sonar"'。 可选模型包括 '"sonar-deep-research"', '"sonar-reasoning-pro"', '"sonar-reasoning"', '"sonar-pro"', '"sonar"', '"r1-1776"'。

服务器配置 (Claude Desktop 客户端)

要将 'perplexity-mcp' 服务器添加到 Claude Desktop 客户端，您需要编辑 Claude 的配置文件 'claude_desktop_config.json'。

  • 配置文件路径:

    • macOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
    • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

  • 添加 MCP 服务器配置: 在 'claude_desktop_config.json' 文件中，添加如下 JSON 配置到 servers 字段中 (如果不存在则创建 servers 字段)。

"servers": {
  "perplexity-mcp": {  // 服务器名称，在客户端中用于标识
    "env": {
      "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY",  // 替换为您的 Perplexity API 密钥
      "PERPLEXITY_MODEL": "sonar"  // 可选：指定 Perplexity 模型，默认为 sonar
    },
    "command": "uv",  // 启动服务器的命令
    "args": [  // 启动服务器的命令参数
      "run",
      "perplexity-mcp"
    ]
  }
}

注意: 请将 '"YOUR_PERPLEXITY_API_KEY"' 替换为您实际的 Perplexity API 密钥。

基本使用方法 (Claude Desktop 客户端)

配置完成后，启动 Claude Desktop 客户端。您可以使用如下 Prompt 来测试网页搜索功能：

'Search the web for news about openai in the past week'

当 Claude 客户端识别到需要调用工具时，会弹出提示框，请点击 "Allow for this chat" 以允许工具调用。 之后，您就可以在 Claude 中使用网页搜索功能了。

对于 Cursor 编辑器等其他 MCP 客户端，配置方式类似，请参考仓库 README 中的 Cursor 安装说明进行配置。

信息

分类

网页与API

访问项目