Skip to main content
Glama
tianmu

Perplexica MCP Server

by tianmu
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Perplexica MCP Server

Language: English | 中文

A Model Context Protocol (MCP) server that provides access to Perplexica's AI-powered search engine capabilities.

Features

  • Web Search: General web search using AI

  • Academic Search: Search academic sources and papers

  • YouTube Search: Find and summarize YouTube videos

  • Reddit Search: Search Reddit discussions

  • Writing Assistant: Get help with writing and research

  • Multi-model Support: Use different chat and embedding models

  • Health Monitoring: Check service status and availability

Prerequisites

  • Python 3.10+

  • A running Perplexica instance (default: http://localhost:3000)

  • Optional: OpenAI API key for enhanced search capabilities

Installation

  1. Clone this repository

  2. Install dependencies:

    pip install -r requirements.txt
pip install .

    or

    uv tool install .

Configuration

cline

Configure the server to cline:

{
  "mcpServers": {
    "perplexica": {
      "command": "python",
      "args": [
        "-m", "perplexica_mcp_server.server"
      ],
      "env": {
        "PERPLEXICA_DEFAULT_CHAT_PROVIDER":"custom_openai",
        "PERPLEXICA_DEFAULT_CHAT_MODEL":"gpt-4.1",
        "PERPLEXICA_CUSTOM_OPENAI_BASE_URL":"https://api.poe.com/v1",
        "PERPLEXICA_CUSTOM_OPENAI_KEY":"your_api_key",
        "PERPLEXICA_DEFAULT_EMBEDDING_PROVIDER":"transformers",
        "PERPLEXICA_DEFAULT_EMBEDDING_MODEL":"xenova-bge-small-en-v1.5",
        "PERPLEXICA_OPTIMIZATION_MODE":"balanced",
        "PERPLEXICA_BASE_URL":"http://localhost:3000"
      },
      "timeout": 60,
      "transport": "stdio"
    }
  }
}

or

{
  "mcpServers": {
    "perplexica": {
      "command": "uvx",
      "args": [
        "perplexica-mcp-server"
      ],
      "env": {
        "PERPLEXICA_DEFAULT_CHAT_PROVIDER":"custom_openai",
        "PERPLEXICA_DEFAULT_CHAT_MODEL":"gpt-4.1",
        "PERPLEXICA_CUSTOM_OPENAI_BASE_URL":"https://api.poe.com/v1",
        "PERPLEXICA_CUSTOM_OPENAI_KEY":"your_api_key",
        "PERPLEXICA_DEFAULT_EMBEDDING_PROVIDER":"transformers",
        "PERPLEXICA_DEFAULT_EMBEDDING_MODEL":"xenova-bge-small-en-v1.5",
        "PERPLEXICA_OPTIMIZATION_MODE":"balanced",
        "PERPLEXICA_BASE_URL":"http://localhost:3000"
      },
      "timeout": 60,
      "transport": "stdio"
    }
  }
}

Development

Copy env.example to .env and modify as needed:

cp env.example .env
# Edit .env file to set your configuration

Starting the Server

Run the MCP server with stdio transport:

python -m perplexica_mcp_server.server

Testing

Test the server functionality:

python test/test_client.py

Run test for you perplexica:

python test/test_official_api.py

Output Formats

Supports two output formats:

  • json: Raw JSON data (default)

  • formatted: Human-readable formatted text

License

MIT License

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tianmu/perplexica-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server