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)