Perplexity Sonar MCP

困惑声纳MCP服务器

MCP服务器实现，将Perplexity Sonar模型的强大功能带给Claude Desktop和其他MCP客户端。与传统的MCP服务器不同，此实现提供了对具有网络搜索功能的Perplexity高级AI模型的访问，使Claude能够执行实时网络搜索并在对话中提供最新信息。

为什么困惑声纳MCP？

• 实时网络搜索：在对话期间从网络访问当前信息
• 多种型号：从各种声纳型号中进行选择，以满足您的需求：

- sonar：通用平衡模型 - sonar-pro：增强执行复杂任务的能力 - sonar-reasoning：擅长逻辑推理和分析 - sonar-deep-research：深入研究，综合引用

• 丰富的参数：使用广泛的参数微调您的查询：

- 控制搜索域和近距 - 调整响应格式（markdown/JSON） - 管理温度和令牌生成 - 获取相关问题和图片

• 无缝集成：与Claude Desktop和其他MCP客户端本地协作

需求

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

要验证您的Node.js安装：

node --version  # Should be 18.0.0 or higher

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

1. 下载自
2. 按照操作系统的安装说明进行操作
3. 安装后重新启动终端

用法

使用克劳德桌面

1. 编辑您的Claude Desktop配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加以下配置：

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

1. 重新启动克劳德桌面

单独模式

您还可以在支持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工具：

困惑聊天

参数：

• model （可选）：要使用的型号（默认：“声纳”）

- 选项： - sonar：通用平衡模型 - sonar-pro：增强执行复杂任务的能力 - sonar-reasoning：擅长逻辑推理 - sonar-deep-research：有引文的深入研究

• messages：消息对象数组，包含：

- role：“系统”|“用户”|“助手” - content：string

• 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 （可选）：按最近度筛选搜索结果

- 选项：“月”、“周”、“日”、“小时”

• top_k （可选）：要考虑的最大搜索结果数
• stream （可选）：是否流式传输响应
• presence_penalty （可选）：惩罚代币存在
• frequency_penalty （可选）：惩罚代币频率
• output_format （可选）：响应格式（json或markdown，默认为markdown）

查询示例

以下是您可以使用此服务器向Claude询问的一些示例：

1. 使用默认型号进行基本搜索：

“量子计算的最新进展是什么？”

1. 引用深度研究：

“利用声纳深入研究，解释聚变能的现状。”

1. 特定域搜索：

“仅在arxiv.org和nature.com上搜索有关大型语言模型的最新论文。”

1. 最近的新闻搜索：

“本周人工智能研究发生了什么？使用search_recency_filter:'week'”

发展

1. 克隆存储库：

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

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

1. 在开发模式下运行：

   npm run dev

故障排除

如果您遇到问题：

1. 验证您的API密钥是否正确
2. 检查Node.js版本兼容性
3. 在Claude Desktop日志中查找错误：

- macOS： ~/Library/Logs/Claude/mcp.log - 窗户： %APPDATA%\Claude\logs\mcp.log

1. 尝试在独立模式下运行以隔离问题

许可证

麻省理工学院