Daily Todo

🚀 Testable Tasks

An MCP server implementation that integrates the Sonar API, providing Claude with unparalleled real-time web search capabilities.

🛠️ Tools

• perplexity_ask
  • Engage in real-time web search conversations using the Sonar API.
  • Input:
    • messages (array): An array of conversation messages.
      • Each message must contain:
        • role (string): The role of the message (e.g., system, user, assistant).
        • content (string): The content of the message.

📦 Installation

Step 1: Clone the Repository

Clone this repository:

git clone git@github.com:ppl-ai/modelcontextprotocol.git

Navigate to the perplexity-ask directory and install the necessary dependencies:

cd modelcontextprotocol/perplexity-ask && npm install

Step 2: Obtain a Sonar API Key

1. Register for a Sonar API account here.
2. Follow the account setup instructions to generate an API key from the developer dashboard.
3. Set the API key as an environment variable PERPLEXITY_API_KEY.

Step 3: Configure Claude Desktop

1. Download the Claude desktop client here.
2. Add the following content to your claude_desktop_config.json:

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PERPLEXITY_API_KEY",
        "mcp/perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX Configuration

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": [
        "-y",
        "server-perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You can access the file using the following command:

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

Step 4: Build the Docker Image

Build the Docker image:

docker build -t mcp/perplexity-ask:latest -f Dockerfile .

Step 5: Testing

Ensure that Claude Desktop detects the two tools exposed by our perplexity-ask server. You can confirm this by looking for the hammer icon:

After clicking the hammer icon, you should see the tools provided with the file system MCP server:

If you see these two tools, the integration is activated. Congratulations! This means Claude can now use Perplexity. You can use it just like the Perplexity web application.

Step 6: Advanced Parameters

The current search parameters are set to default. You can directly modify any search parameters in the API call within the index.ts script. Refer to the official API documentation for more information.

Troubleshooting

The Claude documentation provides an excellent troubleshooting guide that you can refer to. However, if you need assistance, you can contact us at api@perplexity.ai or report an issue.

📄 License

This MCP server is released under the MIT License. This means you can use, modify, and distribute the software without restrictions, subject to the terms of the MIT License. For more details, refer here.