Perplexity Sonar MCP

🚀 Perplexity Sonar MCP 服务器

这是一个强大的 MCP 服务器，实现了 Perplexity 的 Sonar 模型，为 Claude Desktop 及其他 MCP 客户端提供支持。与传统 MCP 服务器不同，它能让你访问 Perplexity 的高级 AI 模型，这些模型具备网络搜索功能，可使 Claude 在对话中实时进行网络搜索并提供最新信息。

🚀 快速开始

本服务器可让你轻松使用 Perplexity 的 Sonar 模型，为 Claude 等工具赋予网络搜索能力。以下是具体的使用步骤。

✨ 主要特性

• 实时网络搜索：在对话期间获取当前的信息。
• 多款模型可供选择：根据需求挑选合适的 Sonar 模型：
  • sonar：平衡的通用模型。
  • sonar - pro：增强功能，适用于复杂任务。
  • sonar - reasoning：专注于逻辑推理和分析。
  • sonar - deep - research：深入研究，附带详尽引用。
• 丰富的参数选项：通过大量参数微调查询：
  • 控制搜索域和时效性。
  • 调整响应格式（Markdown/JSON）。
  • 设置温度和令牌生成限制。
  • 获取相关问题及图片。
• 无縫集成：与 Claude Desktop 和其他工具完美兼容。

📦 安装指南

安装要求

1. 操作系统：Windows、macOS 或 Linux。
2. Node.js 版本：>=14.x.x。
3. 网络连接：需要访问互联网以获取数据。

安装步骤

通过 npm 包管理器安装

npm install -g perlexity-sonar-mcp-server

独立运行模式

1. 克隆仓库：

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

2. 安装依赖：

npm install

3. 启动服务器：

npm start

💻 使用示例

在 Claude Desktop 中使用

1. 打开终端或命令提示符。
2. 启动服务器：

mcp-server start --port 3000

3. 在 Claude Desktop 的设置中配置 MCP 服务器地址为 http://localhost:3000。

代码示例

基本搜索

const perplexityMcp = new PerplexitySonarMCP();
const result = await perplexityMcp.search("AI 的现状");

指定模型和域

const options: SearchOptions = {
  model: "sonar-deep-research",
  domain: ["arxiv.org", "nature.com"],
  searchRecency: "week"
};
const result = await perplexityMcp.search("大语言模型的最新研究", options);

📚 详细文档

API 参考

接口定义

interface PerplexitySonarMCP {
  search(query: string, options?: SearchOptions): Promise<SearchResult>;
}

搜索选项

type SearchOptions = {
  model?: "sonar" | "sonar-pro" | "sonar-reasoning" | "sonar-deep-research";
  domain?: string[];
  searchRecency?: "hour" | "day" | "week" | "month";
  maxResults?: number;
};

搜索结果

type SearchResult = {
  results: ResultItem[];
  error?: string;
};

type ResultItem = {
  title: string;
  url: string;
  content: string;
  source: string;
  date: string;
};

🔧 技术细节

开发步骤

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 许可证。