Perplexity MCP Server N01

🚀 Perplexity MCP Server

A Model Context Protocol (MCP) server for the Perplexity API, written in Go. This server enables AI assistants such as Claude (Code and Desktop versions) and Cursor to seamlessly access Perplexity's powerful search and reasoning capabilities directly through their interfaces.

🚀 Quick Start

The Perplexity MCP server serves as a bridge between AI assistants and the Perplexity API, enabling them to:

1. Search the web and obtain the latest information using Perplexity's Sonar Pro model via the perplexity_ask tool.
2. Perform complex reasoning tasks using Perplexity's Sonar Reasoning Pro model via the perplexity_reason tool.

This integration allows AI assistants like Claude to obtain real - time information and conduct professional reasoning without leaving their interfaces, providing users with a seamless experience.

✨ Features

Key Advantages

• Access to real - time information: Get the latest data, news, and information from the web.
• Enhanced reasoning ability: Utilize specialized models to solve complex problems.
• Smooth integration: Natively compatible with Claude Code, Claude Desktop, and Cursor.
• Easy installation: Quickly install using Homebrew, Go, or pre - built binaries.
• Customizability: Configure different Perplexity models for different tasks.

📦 Installation

Using Homebrew (macOS and Linux)

brew tap alcova-ai/tap
brew install perplexity-mcp

From Source Code

Clone the repository and build manually:

git clone https://github.com/Alcova-AI/perplexity-mcp.git
cd perplexity-mcp
go build -o perplexity-mcp-server .

From Binary Releases (Other Platforms)

Download pre - built binaries from the Releases page.

💻 Usage Examples

Basic Usage

The server only supports the stdio protocol for MCP communication.

Configuration with Claude Code

Add it to Claude Code:

claude mcp add-json --scope user perplexity-mcp '{"type":"stdio","command":"perplexity-mcp","env":{"PERPLEXITY_API_KEY":"pplx-YOUR-API-KEY-HERE"}}'

That's it! You can now use Perplexity in Claude Code.

Configuration with Claude Desktop

Add it to Claude Desktop:

1. Exit the MCP configuration of Claude Desktop:

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

2. Add the Perplexity MCP server:

{
    "mcpServers": {
+        "perplexity-mcp": {
+            "command": "perplexity-mcp",
+            "args": [
+                "--model",
+                "sonar-pro",
+                "--reasoning-model",
+                "sonar-reasoning-pro"
+            ],
+            "env": {
+                "PERPLEXITY_API_KEY": "pplx-YOUR-API-KEY-HERE"
+            }
+        }
    }
}

Advanced Usage

Command - line Options

• --model, -m: Specify the Perplexity model for searching (default: "sonar-pro"). It can be set via the environment variable PERPLEXITY_MODEL.
• --reasoning-model, -r: Specify the Perplexity model for reasoning (default: "sonar-reasoning-pro"). It can be set via the environment variable PERPLEXITY_REASONING_MODEL.

Example:

perplexity-mcp --model sonar-pro --reasoning-model sonar-reasoning-pro

Direct Execution

If you want to run the server directly (not recommended for most users):

1. Set the environment variable:

export PERPLEXITY_API_KEY="your-api-key"

2. Run the server:

./perplexity-mcp-server

📄 License

MIT License