Perplexity MCP 服务器

一个 MCP 服务器，它使用 Perplexity 的 API 提供网络搜索功能，并根据查询意图自动选择模型。

<a href="https://glama.ai/mcp/servers/6qmvjay9z5"> <img width="380" height="200" src="https://glama.ai/mcp/servers/6qmvjay9z5/badge" alt="Perplexity Server MCP server" /> </a>

前提条件

• Node.js (v14 或更高版本)
• 一个 Perplexity API 密钥 (在 https://www.perplexity.ai/settings/api 获取)
• Claude 桌面应用

安装

通过 Git 安装

1. 克隆此仓库：

   git clone https://github.com/RossH121/perplexity-mcp.git
   cd perplexity-mcp
   

2. 安装依赖项：

   npm install
   

3. 构建服务器：

   npm run build
   

配置

1. 从 https://www.perplexity.ai/settings/api 获取您的 Perplexity API 密钥

2. 将服务器添加到 Claude 的配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "perplexity-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/perplexity-mcp/build/index.js"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here",
        "PERPLEXITY_MODEL": "sonar"
      }
    }
  }
}

将 /absolute/path/to 替换为您克隆仓库的实际路径。

可用模型

该服务器现在支持基于查询意图的自动模型选择，但您也可以使用 PERPLEXITY_MODEL 环境变量指定默认模型。可用选项：

• sonar-deep-research - 专门用于跨领域的广泛研究和专家级分析
• sonar-reasoning-pro - 针对高级逻辑推理和复杂问题解决进行了优化
• sonar-reasoning - 专为具有平衡性能的推理任务而设计
• sonar-pro - 通用模型，具有出色的搜索能力和引用密度
• sonar - 快速高效，适用于简单的查询

默认模型（在环境变量中指定）将用作自动模型选择的基线。

有关最新的模型定价和可用性，请访问：https://docs.perplexity.ai/guides/pricing

用法

配置服务器并重启 Claude 后，您可以简单地要求 Claude 搜索信息。例如：

• "SpaceX 的最新消息是什么？"
• "搜索芝加哥最好的餐厅"
• "查找有关爵士乐历史的信息"
• "我需要对最近的人工智能发展进行深入的研究分析" (使用 sonar-deep-research)
• "帮我推理解决这个复杂的问题" (使用 sonar-reasoning-pro)

Claude 将自动使用 Perplexity 搜索工具来查找并返回相关信息。服务器将根据您的查询意图自动选择最合适的模型。

如果由于任何原因它决定不使用搜索工具，您可以通过在提示前加上 "Search the web" 来强制执行。

智能模型选择

服务器会根据您的查询自动选择最合适的 Perplexity 模型：

• 使用研究导向的术语，如 "deep research"（深入研究）、"comprehensive"（全面的）或 "in-depth"（深入的）来触发 sonar-deep-research
• 使用推理术语，如 "solve"（解决）、"figure out"（弄清楚）或 "complex problem"（复杂问题）来触发 sonar-reasoning-pro
• 使用简单的术语，如 "quick"（快速的）、"brief"（简短的）或 "basic"（基本的）来触发轻量级的 sonar 模型
• 一般搜索术语默认为 sonar-pro，以实现平衡的性能

每个搜索响应都包含有关使用哪个模型以及原因的信息。

域名过滤

此服务器支持域名过滤，以自定义您的搜索体验。您可以使用以下命令允许或阻止特定域名：

• 添加允许的域名："Use the domain_filter tool to allow wikipedia.org" (使用 domain_filter 工具允许 wikipedia.org)
• 添加阻止的域名："Use the domain_filter tool to block pinterest.com" (使用 domain_filter 工具阻止 pinterest.com)
• 查看当前过滤器："Use the list_filters tool" (使用 list_filters 工具) (显示域名和时间范围过滤器)
• 清除所有过滤器："Use the clear_filters tool" (使用 clear_filters 工具) (清除域名和时间范围过滤器)

注意: Perplexity API 最多支持 3 个域名，并优先考虑允许的域名。域名过滤需要支持此功能的 Perplexity API 层。

使用流程示例：

1. "Use the domain_filter tool to allow wikipedia.org" (使用 domain_filter 工具允许 wikipedia.org)
2. "Use the domain_filter tool to allow arxiv.org" (使用 domain_filter 工具允许 arxiv.org)
3. "Use the list_filters tool" (使用 list_filters 工具) (验证您的设置)
4. "Search for quantum computing advances" (搜索量子计算进展) (结果将优先考虑 wikipedia.org 和 arxiv.org)

时间范围过滤

您可以使用时间范围过滤器将搜索结果限制在特定的时间窗口内：

• 设置时间范围过滤器："Use the recency_filter tool with filter=hour" (使用 recency_filter 工具，filter=hour) (选项：hour, day, week, month)
• 禁用时间范围过滤器："Use the recency_filter tool with filter=none" (使用 recency_filter 工具，filter=none)

这对于时间敏感的查询（如时事或突发新闻）特别有用。

模型选择控制

虽然自动模型选择在大多数情况下都运行良好，但您可以手动控制使用哪个模型：

• 查看模型信息："Use the model_info tool" (使用 model_info 工具)
• 设置特定模型："Use the model_info tool with model=sonar-deep-research" (使用 model_info 工具，model=sonar-deep-research)
• 返回自动选择：将模型设置回默认模型

使用示例：

1. "Use the model_info tool" (使用 model_info 工具) (查看可用模型和当前状态)
2. "Use the model_info tool with model=sonar-reasoning-pro" (使用 model_info 工具，model=sonar-reasoning-pro) (强制使用推理模型)
3. "Search for a mathematical proof of the Pythagorean theorem" (搜索勾股定理的数学证明) (将使用 sonar-reasoning-pro)
4. "Use the model_info tool with model=sonar-pro" (使用 model_info 工具，model=sonar-pro) (返回自动选择)

开发

要修改服务器：

1. 编辑 src/index.ts
2. 使用 npm run build 重新构建
3. 重新启动 Claude 以加载更改

许可证

MIT