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）
  • 管理温度和令牌生成
  • 获取相关问题和图像
• 无缝集成：与 Claude Desktop 和其他 MCP 客户端原生配合使用

要求

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

要验证您的 Node.js 安装：

node --version  # 应该为 18.0.0 或更高版本

如果未安装 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（可选）：要生成的最大令牌数
• 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（可选）：惩罚令牌存在
• frequency_penalty（可选）：惩罚令牌频率
• 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