Perplexity Tool for Claude Desktop

一个自定义的MCP工具，集成Perplexity AI的API与Claude Desktop，使Claude能够执行基于网络的研究并提供带有引用的答案。

预备安装

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中的命令来使用该工具：

• "询问Perplexity关于AI的最新发展"
• "使用Perplexity研究量子计算的历史"
• "搜索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文件中