Modelcontextprotocol

🚀 Perplexity Ask MCP Server

An MCP server implementation integrating the Sonar API, enabling Claude to conduct real-time network-wide research.

Please refer to the official DeepWiki page for implementation assistance.

🚀 Quick Start

Configuration

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 the Sonar API Key

1. Sign up on the Sonar API account.
2. Follow the account setup instructions to generate your API key from the developer console.
3. Set the API key as the 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

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": [
        "-y"
      ]
    }
  }
}

✨ Features

Advanced System Architecture

Credits: DeepWiki powered by Devin

Tools

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