AI导哈

AI模型集成服务器

Perplexity Sonar MCP Server是一个实现MCP协议的服务器，将Perplexity的Sonar AI模型集成到Claude Desktop等MCP客户端中，提供实时网络搜索和多种AI模型选择功能。

  • by felores
  • JavaScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 felores/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. 下载自 nodejs.org
  2. 按照操作系统的安装说明进行操作
  3. 安装后重新启动终端

用法

使用克劳德桌面

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

    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %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. 重新启动克劳德桌面

单独模式

您还可以在支持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. 使用默认型号进行基本搜索： “量子计算的最新进展是什么？”

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

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

  4. 最近的新闻搜索： “本周人工智能研究发生了什么？使用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
    • 窗户： %APPDATA%\Claude\logs\mcp.log
  4. 尝试在独立模式下运行以隔离问题

许可证

麻省理工学院

相关 MCP