perplexica-mcp

thetom42/perplexica-mcp

3.3

If you are the rightful owner of perplexica-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Perplexica MCP Server is a Model Context Protocol server that leverages Perplexica's AI-powered search engine to provide advanced search functionalities.

The Perplexica MCP Server is designed to offer a robust and versatile search solution using the power of Perplexica's AI-driven search engine. It supports multiple transport modes, including stdio, SSE, and Streamable HTTP, ensuring compatibility with a wide range of MCP clients and applications. Built on the FastMCP framework, the server ensures compliance with MCP protocol standards, providing a unified architecture that simplifies deployment and integration. With Docker support, the server is production-ready, incorporating security best practices to ensure safe and reliable operation. The server's AI-powered search tool offers various focus modes, catering to different search needs, from web and academic searches to writing assistance and more. This makes it an ideal choice for developers and organizations looking to integrate advanced search capabilities into their applications.

Features

  • AI-powered web search with multiple focus modes
  • Supports stdio, SSE, and Streamable HTTP transports
  • Built using FastMCP for robust MCP protocol compliance
  • Single server implementation supporting all transport modes
  • Docker support with security best practices

Usages

usage with claude desktop stdio

{
  "mcpServers": {
    "perplexica": {
      "command": "uvx",
      "args": ["perplexica-mcp", "stdio"],
      "env": {
        "PERPLEXICA_BACKEND_URL": "http://localhost:3000/api/search"
      }
    }
  }
}

usage with claude desktop sse

{
  "mcpServers": {
    "perplexica": {
      "url": "http://localhost:3001/sse"
    }
  }
}

usage with cursor ide stdio

{
  "servers": {
    "perplexica": {
      "command": "uvx",
      "args": ["perplexica-mcp", "stdio"],
      "env": {
        "PERPLEXICA_BACKEND_URL": "http://localhost:3000/api/search"
      }
    }
  }
}

usage with generic mcp client stdio

bash
# Command to run the server (PyPI installation)
uvx perplexica-mcp stdio

# Command to run the server (from source)
uv run /path/to/perplexica-mcp/src/perplexica_mcp.py stdio

# Environment variables
PERPLEXICA_BACKEND_URL=http://localhost:3000/api/search

usage with generic mcp client http sse

bash
# Start the server (PyPI installation)
uvx perplexica-mcp sse  # or 'http'

# Start the server (from source)
uv run /path/to/perplexica-mcp/src/perplexica_mcp.py sse  # or 'http'

# Connect to endpoints
SSE: http://localhost:3001/sse
HTTP: http://localhost:3002/mcp/

Tools

  1. search

    Performs AI-powered web search using Perplexica.