STARWARCLOUD STARWAR.AI
返回市场
困惑声纳MCP服务器

困惑声纳MCP服务器

作者：felores9 星标更新：2025-04-04
安装使用来源：spider==github.com

项目介绍

Perplexity Sonar MCP 服务器

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

为什么选择 Perplexity Sonar MCP？

  • 实时网络搜索：在对话中获取当前的网络信息。
  • 多种模型：从各种 Sonar 模型中选择以满足您的需求：
    • sonar：适用于一般用途的平衡模型。
    • sonar-pro：增强的功能用于复杂任务。
    • sonar-reasoning：专长于逻辑推理和分析。
    • sonar-deep-research：深入研究并提供全面引用。
  • 丰富的参数：通过广泛的参数微调查询：
    • 控制搜索领域和时效性。
    • 调整响应格式（markdown/JSON）。
    • 管理温度和令牌生成。
    • 获取相关问题和图片。
  • 无缝集成：原生支持 Claude Desktop 和其他 MCP 客户端。

系统要求

验证您的 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. 最近新闻搜索： "本周在人工智能研究中发生了什么？使用 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