🚀 Perplexity Sonar MCP 服务器
Perplexity Sonar MCP 服务器是一个强大的 MCP 服务器，它实现了 Perplexity 的 Sonar 模型，为 Claude Desktop 及其他 MCP 客户端提供支持。与传统 MCP 服务器不同，该实现提供了对 Perplexity 高级 AI 模型的访问权限，这些模型具备网络搜索功能，能让 Claude 在对话中实时执行网络搜索并提供最新信息。
🚀 快速开始
本服务器能为你提供具备网络搜索功能的高级 AI 模型服务。你可以根据以下步骤进行安装和使用。
✨ 主要特性
- 实时网络搜索：在对话期间获取当前的信息。
- 多款模型可供选择：根据需求挑选合适的 Sonar 模型：
sonar：平衡的通用模型。sonar - pro：增强功能，适用于复杂任务。sonar - reasoning：专注于逻辑推理和分析。sonar - deep - research：深入研究，附带详尽引用。
- 丰富的参数选项：通过大量参数微调查询：
- 控制搜索域和时效性。
- 调整响应格式（Markdown/JSON）。
- 设置温度和令牌生成限制。
- 获取相关问题及图片。
- 无縫集成：与 Claude Desktop 和其他工具完美兼容。
📦 安装指南
安装要求
- 操作系统：Windows、macOS 或 Linux。
- Node.js 版本：>=14.x.x。
- 网络连接：需要访问互联网以获取数据。
安装步骤
通过 npm 包管理器安装
npm install -g perlexity-sonar-mcp-server
独立运行模式
- 克隆仓库：
git clone https://github.com/felores/perplexity-sonar-mcp.git
cd perplexity-sonar-mcp
- 安装依赖：
npm install
- 启动服务器：
npm start
💻 使用示例
在 Claude Desktop 中使用
- 打开终端或命令提示符。
- 启动服务器：
mcp-server start --port 3000
- 在 Claude Desktop 的设置中配置 MCP 服务器地址为
http://localhost:3000。
代码示例
示例 1：基本搜索
const perplexityMcp = new PerplexitySonarMCP();
const result = await perplexityMcp.search("AI 的现状");
示例 2：指定模型和域
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;
};
🔧 技术细节
开发步骤
- 克隆仓库：
git clone https://github.com/felores/perplexity-sonar-mcp.git
cd perplexity-sonar-mcp
- 安装依赖：
npm install
- 构建项目：
npm run build
- 开发模式启动：
npm run dev
故障排除
- 验证 API 密钥是否正确。
- 确保 Node.js 版本符合要求。
- 检查 Claude Desktop 日志：
- macOS:
~/Library/Logs/Claude/mcp.log - Windows:
%APPDATA%\Claude\logs\mcp.log
- 尝试独立模式运行以隔离问题。
📄 许可证
本项目采用 MIT 许可证。