perplexity-mcp-server 0.2.1

Perplexity MCP Server

Perplexity MCP Server

A Model Context Protocol (MCP) server that provides reasoning with deepseek R1, web search and citations functionality using Perplexity AI's API. Works with the Anthropic Claude desktop and compatible MCP clients.

Features

• Web search using Perplexity AI
• Recency filtering (day/week/month/year)
• Multiple model support (sonar/sonar-pro/sonar-reasoning)
• Citations support for search results

Installation

Prerequisites

1. Python 3.11 or higher
2. UV package manager:

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

User Installation (PyPI)

For users who want to use the MCP server:

uv pip install perplexity-mcp-server

Developer Installation (Local)

For developers who want to modify the server:

# Clone the repository
git clone https://github.com/felores/perplexity-mcp-server.git
cd perplexity-mcp-server

# Create and activate virtual environment
uv venv .venv
.\.venv\Scripts\activate  # Windows
source .venv/bin/activate # Unix

# Install in development mode
uv pip install -e .

Configuration

Claude Desktop Setup

1. Get your API key from Perplexity AI

2. Edit Claude's config file:

• Windows: %APPDATA%/Claude/claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

For Users (PyPI Installation)

{
  "perplexity-reasoning": {
    "env": {
      "PERPLEXITY_API_KEY": "your-api-key-here",
      "PERPLEXITY_MODEL": "sonar-reasoning"
    },
    "command": "uv",
    "args": ["run", "perplexity-mcp-server"]
  }
}

For Developers (Local Installation)

{
  "perplexity-reasoning": {
    "env": {
      "PERPLEXITY_API_KEY": "your-api-key-here",
      "PERPLEXITY_MODEL": "sonar-reasoning",
      "PYTHONPATH": "path/to/your/project/src"
    },
    "command": "python",
    "args": ["path/to/your/project/src/perplexity_mcp/run.py"]
  }
}

Available Models

• sonar: Standard model (127k context)
• sonar-pro: Advanced model (200k context)
• sonar-reasoning: Chain of Thought model (127k context)

If no model is specified, defaults to sonar.

Usage

1. Open Claude desktop client
2. Try a prompt like: "Search the web for recent news about AI"
3. Click "Allow for this chat" when prompted

Development

For development instructions, see DEVELOPMENT.md