Perplexity MCP 服务器

一个自定义的 模型上下文协议 (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 格式
• 通过将 "DEBUG": "1" 添加到 env 部分来启用详细日志记录

工作原理

此实现使用 Anthropic 创建的模型上下文协议 (MCP) 来扩展 Claude Desktop 的功能。 它：

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

许可证

该项目根据 ISC 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。