Claude Desktop 的 Perplexity 工具

一个自定义的 MCP 工具，将 Perplexity AI 的 API 与 Claude Desktop 集成，允许 Claude 执行基于 Web 的研究并提供带有引用的答案。

前提条件安装

1. 安装 Git：

   • 对于 Mac：
     • 首先安装 Homebrew，方法是在终端中粘贴以下内容：

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
     

     • 然后安装 Git：

     brew install git
     

   • 对于 Windows：
     • 从 git-scm.com 下载 Git
     • 运行安装程序

2. 安装 Node.js：

   • 对于 Mac：

     brew install node
     

   • 对于 Windows：
     • 从 nodejs.org 下载
     • 运行安装程序

3. 通过运行以下命令验证安装：

git --version
node --version

工具安装

1. 克隆存储库

git clone https://github.com/letsbuildagent/perplexity-tool
cd perplexity-tool

2. 安装依赖项

npm install

3. 设置您的 API 密钥

您有两种选择：

选项 1（快速设置）：

• 打开 server.js
• 找到这一行：

const PERPLEXITY_API_KEY = "YOUR-API-KEY-HERE";

• 替换为您的 Perplexity API 密钥

选项 2（最佳实践）：

• 创建一个 .env 文件：

  # 在 Mac/Linux 上：
  touch .env
  open .env
  
  # 在 Windows 上：
  notepad .env
  

  或者直接在您的文本编辑器中创建一个名为 .env 的新文件
• 将您的 API 密钥添加到 .env 文件：

  PERPLEXITY_API_KEY=your-api-key-here
  

• 安装 dotenv：

  npm install dotenv
  

• 更新 server.js：

  import 'dotenv/config'
  const PERPLEXITY_API_KEY = process.env.PERPLEXITY_API_KEY;
  

4. 配置 Claude Desktop

• 打开 ~/Library/Application Support/Claude/claude_desktop_config.json
• 添加此配置：

{
  "mcpServers": {
    "perplexity-tool": {
      "command": "node",
      "args": [
        "/full/path/to/perplexity-tool/server.js"
      ]
    }
  }
}

将 /full/path/to 替换为您克隆存储库的实际路径。

5. 重启 Claude Desktop

用法

安装完成后，您可以通过 Claude 使用该工具，例如：

• "Ask Perplexity about recent developments in AI" (向 Perplexity 询问人工智能的最新发展)
• "Use Perplexity to research the history of quantum computing" (使用 Perplexity 研究量子计算的历史)
• "Search Perplexity for information about climate change, focusing on the last month" (在 Perplexity 上搜索有关气候变化的信息，重点关注最近一个月)

高级选项

您可以指定其他参数：

• temperature：控制响应随机性 (0-2)
• max_tokens：限制响应长度
• search_domain_filter：将搜索限制为特定域
• search_recency_filter：按时间段过滤（天/周/月/年）

故障排除

1. Git 未找到：

   • 确保您已正确安装 Git
   • 尝试重启您的终端
   • 在 Mac 上，确保 Homebrew 在您的 PATH 中

2. Node.js 错误：

   • 使用 node --version 验证 Node.js 安装
   • 尝试重新安装 Node.js

3. API 密钥问题：

   • 确保您已正确复制您的 API 密钥
   • 检查您的 .env 文件中是否有额外的空格
   • 如果使用选项 2，请验证是否已安装 dotenv

4. 工具未出现在 Claude 中：

   • 检查 claude_desktop_config.json 中的路径
   • 确保路径指向您的 server.js 文件
   • 重启 Claude Desktop
   • 检查控制台是否有任何错误消息

许可证

MIT

安全提示

如果您计划共享您的代码或将其公开：

• 不要将您的 API 密钥提交到 Git
• 使用 .env 方法（选项 2）
• 将 .env 添加到您的 .gitignore 文件