Perplexity MCP 服务器

这是一个自定义的 Model Context Protocol (MCP) 实现，它将 Perplexity AI 作为工具提供商集成到 Claude Desktop 中。

特性

• 通过 MCP 无缝集成到 Claude Desktop
• 访问 Perplexity 强大的 AI 模型
• 支持单个问题和多轮对话
• 自定义模型选择

安装

先决条件

• Node.js (v16 或更高版本)
• Claude Desktop (最新版本)
• Perplexity API 密钥

方案 1：克隆并本地运行

1. 克隆此仓库：

   git clone https://github.com/Family-IT-Guy/perplexity-mcp.git
   cd perplexity-mcp
   

2. 安装依赖项：

   npm install
   

3. 创建一个包含你的 API 密钥的 .env 文件：

   PERPLEXITY_API_KEY=your_api_key_here
   

4. 测试服务器：

   node server.js
   

方案 2：全局安装

1. 如上所述克隆并导航到仓库

2. 全局安装：

   npm install -g .
   

3. 现在你可以从任何地方运行服务器：

   perplexity-mcp
   

Claude Desktop 配置

将以下配置添加到你的 claude_desktop_config.json 文件中：

标准配置

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": [
        "/absolute/path/to/perplexity-mcp/server.js"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your_perplexity_api_key"
      }
    }
  }
}

全局安装配置

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": [
        "perplexity-mcp"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your_perplexity_api_key"
      }
    }
  }
}

使用 NVM 的用户

如果你使用 Node Version Manager (NVM)，你需要绝对路径：

{
  "mcpServers": {
    "perplexity": {
      "command": "/Users/username/.nvm/versions/node/v16.x.x/bin/node",
      "args": [
        "/Users/username/path/to/perplexity-mcp/server.js"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your_perplexity_api_key"
      }
    }
  }
}

可用工具

配置完成后，Claude 将可以访问这些工具：

1. perplexity_ask - 向 Perplexity 发送单个问题

   • 参数：
     • query (必需)：要询问的问题
     • model (可选)：模型名称（默认：llama-3.1-sonar-small-128k-online）

2. perplexity_chat - 进行多轮对话

   • 参数：
     • messages (必需)：对话消息数组
     • model (可选)：模型名称（默认：mixtral-8x7b-instruct）

故障排除

• 查看日志：cat ~/.claude/logs/perplexity.log
• 确保你的 API 密钥有效
• 验证你的 claude_desktop_config.json 格式
• 通过在 env 部分添加 "DEBUG": "1" 来启用详细日志记录

工作原理

此实现使用由 Anthropic 创建的 Model Context Protocol (MCP) 扩展 Claude Desktop 的功能。它：

1. 创建一个与 Claude 通过 stdio 通信的 MCP 服务器
2. 注册 Perplexity 工具到 Claude
3. 代理来自 Claude 的请求到 Perplexity API
4. 将响应返回给 Claude 以供显示

许可证

本项目根据 ISC 许可证发布 - 详情见 LICENSE 文件。