Laodev1 Perplexity MCP Server

🚀 Perplexity MCP 服務器

Perplexity MCP 服務器基於 Node.js 實現了 Anthropic 的模型上下文協議（MCP），它就像一座安全的橋樑，能讓 Claude 與 Perplexity 的語言模型進行交互，藉助工具使用實現更強大的 AI 互動。

🚀 快速開始

安裝步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/perplexity-mcp-server.git
cd perplexity-mcp-server

2. 安裝依賴項：

npm install

3. 創建 .env 文件：

PERPLEXITY_API_KEY=your-api-key-here

4. 構建項目：

npm run build

Claude Desktop 配置

要將此服務器添加到 Claude Desktop，請更新你的 claude_desktop_config.json：

{
  "mcpServers": {
    //more servers...
    "perplexity": {
      "command": "node",
      "args": ["path\\to\\perplexity-mcp-server\\dist\\index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY"
      }
    }
    //more servers...
  }
}

配置文件通常位於：

• Windows: %APPDATA%/Claude/config/claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/config/claude_desktop_config.json
• Linux: ~/.config/Claude/config/claude_desktop_config.json

開發啟動

使用自動重新編譯啟動開發服務器：

npm run dev

✨ 主要特性

可用工具

1. perplexity_chat

帶完整消息歷史支持的高級聊天完成工具。

{
  "name": "perplexity_chat",
  "description": "生成 Perplexity AI 的聊天完成",
  "parameters": {
    "model": "string (可選) - 其中之一：llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online",
    "messages": "array of {role, content} 對象 - 對話歷史記錄",
    "temperature": "number (可選) - 採樣溫度，介於 0-2 之間"
  }
}

2. perplexity_ask

簡化的單查詢接口，用於快速提問。

{
  "name": "perplexity_ask",
  "description": "發送簡單的查詢到 Perplexity AI",
  "parameters": {
    "query": "string - 要發送的問題或提示",
    "model": "string (可選) - 其中之一：llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online"
  }
}

💻 使用示例

基礎用法

創建服務器

const { PerplexityServer } = require('@modelcontextprotocol/sdk');

const server = new PerplexityServer({
  port: 3000,
  apiKey: 'your-api-key-here'
});

server.start();

發送查詢

{
  "name": "perplexity_ask",
  "description": "發送簡單的查詢到 Perplexity AI",
  "parameters": {
    "query": "string - 要發送的問題或提示",
    "model": "string (可選) - 其中之一：llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online"
  }
}

🔧 技術細節

• 使用 TypeScript 實現類型安全。
• 通過 @modelcontextprotocol/sdk 實現 MCP 協議。
• 通過 stdio 傳輸進行通信。
• 環境變量配置管理。

🔧 核心組件

核心組件

1. PerplexityServer 類
   • 實現 MCP 服務器協議。
   • 處理工具註冊和執行。
   • 管理錯誤處理和服務器生命週期。
2. Tools System
   • 模塊化工具定義。
   • 類型安全的工具處理器。
   • 結構化輸入驗證。

🔧 錯誤處理

服務器實現全面的錯誤處理：

• API 錯誤報告。
• 無效工具請求處理。
• 連接錯誤管理。
• 進程信號處理。

📦 依賴項

• @modelcontextprotocol/sdk
• node

安裝命令：

npm install @modelcontextprotocol/sdk node