Perplexity Tool For Claude Desktop

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

本项目主要用于将 Perplexity 工具集成到相关环境中，借助该工具可在 Claude 中实现对各类信息的搜索，如 AI 最新发展、量子计算历史、气候变化信息等。

🚀 快速开始

在使用该工具前，需要完成一系列的安装和配置工作，具体步骤如下。

📦 安装指南

先决条件安装

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](https://git-scm.com/downloads) 下载并安装 Git。
- 运行安装程序。

2. 安装 Node.js
   • Mac 系统：

brew install node

- **Windows 系统**：
- 访问 [nodejs.org](https://nodejs.org/) 下载安装程序。
- 运行安装程序。

3. 验证安装 运行以下命令来验证 Git 和 Node.js 是否安装成功：

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 密钥替换 `"YOUR-API-KEY-HERE"`。

• 最佳实践：
  • 创建 .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 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"]
}
}
}
}

🛠️ 故障排除

Git 相关问题

• 确保已正确安装 Git 并将其添加到系统的 PATH 环境变量中。
• 检查 Git 版本：git --version

Node.js 相关问题

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

API 密钥问题

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

集成问题

• 确保配置文件路径正确。
• 检查控制台输出的错误信息，根据错误信息进行相应的处理。