Perplexity Tool For Claude Desktop

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

本項目提供了 Perplexity 工具的集成方案，幫助你在 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 和 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"]
            }
        }
    }
}

🔧 技術細節

故障排除

1. Git 相關問題：
   • 確保已正確安裝 Git 並將其添加到系統的 PATH 環境變量中。
   • 檢查 Git 版本：git --version
2. Node.js 相關問題：
   • 確保 Node.js 和 npm 已正確安裝。
   • 檢查 Node.js 版本：node --version
3. API 密鑰問題：
   • 確保密鑰格式正確且有效。
   • 檢查 .env 文件是否正確加載。
4. 集成問題：
   • 確保配置文件路徑正確。
   • 檢查控制檯輸出的錯誤信息。