Perplexity Sonar MCP Server

Perplexity Sonar MCP 服务

一种 MCP 服务实现，可将 Perplexity 的 Sonar 模型强大的功能引入 Claude Desktop 和其他 MCP 客户端。与传统 MCP 服务不同，此实现可访问 Perplexity 的先进 AI 模型及网页搜索功能，让 Claude 在对话中执行实时网页搜索并提供最新信息。

为什么选择 Perplexity Sonar MCP？

• 实时网页搜索：在对话中获取网络上的最新信息
• 多种模型：可选择多种 Sonar 模型以满足需求：
  • sonar：适合通用场景的均衡模型
  • sonar-pro：增强复杂任务处理能力
  • sonar-reasoning：专用于逻辑推理与分析
  • sonar-deep-research：深入研究，提供全面引用
• 丰富的参数：使用丰富的参数微调查询：
  • 控制搜索域名和时效性
  • 调整回复格式（markdown/JSON）
  • 管理温度和 token 生成
  • 获取相关问题和图片
• 无缝集成：原生支持 Claude Desktop 和其他 MCP 客户端

要求

• Node.js 18.0.0 或更高版本
• Perplexity API 密钥（可在 https://www.perplexity.ai/account/api 获取）
• Claude Desktop（用于桌面集成）

验证 Node.js 是否已安装：

node --version  # Should be 18.0.0 or higher

如果尚未安装 Node.js 或需要更新：

1. 从 nodejs.org 下载
2. 按照适用于操作系统的安装说明进行操作
3. 安装后重启终端

使用方法

使用 Claude Desktop

1. 编辑 Claude Desktop 配置文件：

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

2. 添加以下配置：

   {
     "mcpServers": {
       "perplexity": {
         "command": "npx",
         "args": [
           "-y",
           "@felores/perplexity-sonar-mcp"
         ],
         "env": {
           "PERPLEXITY_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

3. 重启 Claude Desktop

独立模式

也可以在独立模式下运行此服务，并启用 HTTP/SSE 支持：

PERPLEXITY_API_KEY=your_api_key_here perplexity-sonar-mcp

默认情况下，这会在端口 3000 上启动服务。也可以指定其他端口：

PERPLEXITY_API_KEY=your_api_key_here PORT=8080 perplexity-sonar-mcp

API 参考

此服务提供以下 MCP 工具：

perplexity-chat

参数：

• model（可选）：要使用的模型（默认值："sonar"）
  • 选项：
    • sonar：适合通用场景的均衡模型
    • sonar-pro：增强复杂任务处理能力
    • sonar-reasoning：专用于逻辑推理
    • sonar-deep-research：深入研究并提供引用
• messages：消息对象数组，包含：
  • role："system" | "user" | "assistant"
  • content：字符串
• temperature（可选）：控制随机性（0-2）
  • 较低的值（例如 0.3）可获得更聚焦的回复
  • 较高的值（例如 0.8）可获得更具创造性的回复
• max_tokens（可选）：要生成的最大 token 数
• top_p（可选）：通过核采样控制多样性（0-1）
• search_domain_filter（可选）：限制引用来源的域名数组
  • 示例：["wikipedia.org", "github.com"]
• return_images（可选）：是否返回搜索结果中的图片
• return_related_questions（可选）：是否返回相关问题
• search_recency_filter（可选）：按时效性筛选搜索结果
  • 选项："month"、"week"、"day"、"hour"
• top_k（可选）：要考虑的最大搜索结果数
• stream（可选）：是否以流式方式返回回复
• presence_penalty（可选）：对 token 的出现情况施加惩罚
• frequency_penalty（可选）：对 token 的频率施加惩罚
• output_format（可选）：回复格式（"json" 或 "markdown"，默认值："markdown"）

示例查询

以下是一些你可以使用此服务向 Claude 提出的问题示例：

1. 使用默认模型进行基本搜索： “量子计算有哪些最新进展？”

2. 进行带引用的深度研究： “使用 sonar-deep-research，说明聚变能源的当前发展状况。”

3. 进行特定领域搜索： “仅在 arxiv.org 和 nature.com 上搜索有关大语言模型的近期论文。”

4. 搜索近期新闻： “本周 AI 研究领域发生了什么？使用 search_recency_filter: 'week'”

开发

1. 克隆代码库：

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

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 在开发模式下运行：

   npm run dev
   

故障排除

如果遇到问题：

1. 确认 API 密钥正确
2. 检查 Node.js 版本是否兼容
3. 查看 Claude Desktop 日志中的错误：
   • macOS：~/Library/Logs/Claude/mcp.log
   • Windows：%APPDATA%\Claude\logs\mcp.log
4. 尝试在独立模式下运行，以隔离问题

许可证

MIT