Laodev1 Perplexity MCP Server

🚀 Perplexity MCP 服务器

Perplexity MCP 服务器基于 Node.js 实现，是 Anthropic 的模型上下文协议（MCP）服务器。它能让 Claude 与 Perplexity 的语言模型进行交互，在 Claude 和 Perplexity AI 的能力之间搭建起安全桥梁，借助工具使用实现更强大的 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