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 許可證。