Perplexity 工具的困惑性工具箱集成说明

先决条件安装

1. 安装 Git：

   • 对于 Mac：
     • 首先安装 Homebrew，在终端中粘贴以下命令：

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

     • 然后安装 Git：

     brew install git
     

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

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 Key

有两种选择方式：

快速设置：

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

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

• 用你的 Perplexity API 密钥替换

最佳实践：

• 创建 .env 文件：

  # 对于 Mac/Linux:
  touch .env
  open .env
  
  # 对于 Windows:
  notepad .env
  

  或者在文本编辑器中新建一个名为 .env 的文件
• 在 .env 文件中添加你的 API 密钥：

  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_lang_filter: 过滤搜索语言

示例配置

{
    "mcpServers": {
        "perplexity-tool": {
            "command": "node",
            "args": [
                "./server.js"
            ],
            "config": {
                "temperature": 0.7,
                "max_tokens": 2048,
                "search_domain_filter": ["example.com"],
                "search_lang_filter": ["en"]
            }
        }
    }
}

故障排除

1. Git 相关问题：

   • 确保已正确安装 Git 并添加到 PATH
   • 检查 Git 版本：git --version

2. Node.js 相关问题：

   • 确保 Node.js 和 npm 已正确安装
   • 检查 Node.js 版本：node --version

3. API 密钥问题：

   • 确保密钥格式正确且有效
   • 检查 .env 文件是否正确加载

4. 集成问题：

   • 确保配置文件路径正确
   • 检查控制台输出的错误信息