Perplexity Tool For Claude Desktop

🚀 Perplexity Tool Integration Guide

Perplexity Tool is a powerful toolbox that integrates the Perplexity API, enabling users to leverage Perplexity's capabilities within the Claude environment. This guide will walk you through the installation and configuration process.

🚀 Quick Start

This guide will walk you through the process of integrating the Perplexity tool into your workflow.

📦 Installation

Prerequisites

1. Install Git:
   • For Mac:
     • First, install Homebrew by pasting the following command in your terminal:

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

    - Then, install Git:

brew install git

- **For Windows**:
    - Download and install Git from [git-scm.com](https://git-scm.com/downloads).
    - Run the installer.

2. Install Node.js:
   • For Mac:

brew install node

- **For Windows**:
    - Visit [nodejs.org](https://nodejs.org/) to download the installer.
    - Run the installer.

3. Verify the installations:

git --version
node --version

Tool Installation

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Configure the API Key You have two options:

Quick Setup:

• Open server.js.
• Find the following line:

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

• Replace it with your Perplexity API key.

Best Practice:

• Create a .env file:

# For Mac/Linux:
touch .env
open .env

# For Windows:
notepad .env

Or create a new file named .env in your text editor.

• Add your API key to the .env file:

PERPLEXITY_API_KEY=your-api-key-here

• Install dotenv:

npm install dotenv

• Update server.js:

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

4. Configure Claude Desktop:

• Open ~/Library/Application Support/Claude/claude_desktop_config.json.
• Add the following configuration:

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

Replace /full/path/to with the actual path where you cloned the repository.

5. Restart Claude Desktop

💻 Usage Examples

Basic Usage

After installation, you can use the tool in Claude with the following commands:

• "Ask Perplexity about the latest developments in AI."
• "Use Perplexity to research the history of quantum computing."
• "Search Perplexity for information on climate change, focusing on the past month."

Advanced Usage

You can specify additional parameters:

• temperature: Controls the randomness of the response (0 - 2).
• max_tokens: Limits the length of the response.
• search_domain_filter: Restricts the search domain.
• search_lang_filter: Filters the search language.

Example Configuration

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

🔧 Troubleshooting

1. Git-related issues:
   • Ensure Git is installed correctly and added to your PATH.
   • Check your Git version: git --version.
2. Node.js-related issues:
   • Ensure Node.js and npm are installed correctly.
   • Check your Node.js version: node --version.
3. API key issues:
   • Ensure your API key is in the correct format and valid.
   • Check if the .env file is loaded correctly.
4. Integration issues:
   • Ensure the configuration file path is correct.
   • Check the error messages in the console output.