Perplexica MCP Server

A Model Context Protocol (MCP) server for interacting with local Perplexica instances. This server provides tools to perform AI-powered searches using your local Perplexica installation.

Features

• Search: Perform AI-powered searches with various focus modes
• Streaming Support: Get real-time streaming responses
• Multiple Focus Modes: Support for web search, academic search, writing assistant, and more
• Customizable Models: Configure chat and embedding models
• Conversation History: Maintain context across searches

Installation

From Source

git clone https://github.com/armand0e/perplexica-mcp.git
cd perplexica-mcp
pip install -e .

From Git (Direct Install)

pip install git+https://github.com/armand0e/perplexica-mcp.git

Configuration

The server connects to a local Perplexica instance. By default, it expects Perplexica to be running on `http://localhost:3000`.

You can configure the base URL by setting the `PERPLEXICA_BASE_URL` environment variable:

export PERPLEXICA_BASE_URL=http://localhost:3001

Usage

With Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "perplexica": {
      "command": "python",
      "args": ["-m", "perplexica_mcp"],
      "env": {
        "PERPLEXICA_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Available Tools

• `perplexica_search`: Perform AI-powered searches with various focus modes
• `perplexica_get_models`: Get available chat and embedding models

Focus Modes

• `webSearch`: General web search
• `academicSearch`: Academic and research-focused search
• `writingAssistant`: Writing and content creation assistance
• `wolframAlphaSearch`: Mathematical and computational queries
• `youtubeSearch`: YouTube video search
• `redditSearch`: Reddit discussion search

Requirements

• Python 3.8+
• A running Perplexica instance (see Perplexica GitHub)