Сервер Model Context Protocol (MCP), который обеспечивает функциональность поиска с помощью поисковой системы Perplexica с искусственным интеллектом.

Особенности

Инструмент поиска : поиск на основе ИИ с несколькими типами источников (веб-, академические, дискуссии) Множественная транспортная поддержка: stdio, SSE и потоковые HTTP-перевозки FastMCP Интеграция Встроенный с использованием FastMCP для надежного соблюдения протокола MCP ** Единая архитектура: Реализация единого сервера, поддерживающего все виды транспорта Производство готово: Docker поддерживает лучшие практики безопасности

##Развитие окружающей среды

для пользователей кода

Важно: Если вы используете Claude Code для разработки, этот проект требует использования MCP-сервера для всех операций разработки. Все операции с файлами, изменения кода и команды оболочки должны выполняться в среде использования контейнеров.

Работа с контейнером (только код)

Вкладывая средства в этот проект с помощью Claude Code, вы должны:

1. **Использовать только контейнер **: все операции с файлами, редактирование кода и команды оболочки должны выполняться с использованием среды использования контейнеров
2. Посмотреть свои работы: После внесения изменений сообщите другим, как получить доступ к вашей работе:

Perplexica MCP Server

A Model Context Protocol (MCP) server that provides search functionality using Perplexica’s AI-powered search engine.

Features

• Search Tool: AI-powered search with multiple source types (web, academic, discussions)
• Multiple Transport Support: stdio, SSE, and Streamable HTTP transports
• FastMCP Integration: Built using FastMCP for robust MCP protocol compliance
• Unified Architecture: Single server implementation supporting all transport modes
• Production Ready: Docker support with security best practices

Development Environment

For Claude Code Users

Important: If you are using Claude Code for development, this project requires the use of the container-use MCP server for all development operations. All file operations, code changes, and shell commands must be executed within container-use environments.

Working with Container-Use (Claude Code Only)

When contributing to this project using Claude Code, you must:

1. Use Container-Use Only: All file operations, code editing, and shell commands must be performed using container-use environments
2. View Your Work: After making changes, inform others how to access your work:
   • Use container-use log to view the development log
   • Use container-use checkout to check out your environment
3. No Local Operations: Do not perform file operations directly on the local filesystem

Example Development Workflow (Claude Code)

# Create a new environment for your work
container-use create --title "Your feature description"

# Make your changes using container-use tools
# (All file operations handled by container-use)

# Share your work with others
container-use log 
container-use checkout 

This ensures consistency, reproducibility, and proper version control for all development activities when using Claude Code.

For Other Development Environments

If you are not using Claude Code, you can develop normally using your preferred tools and IDE. The container-use requirement does not apply to regular development workflows.

Installation

From PyPI (Recommended)

# Install directly from PyPI
pip install perplexica-mcp

# Or using uvx for isolated execution
uvx perplexica-mcp --help

From Source

# Clone the repository
git clone https://github.com/thetom42/perplexica-mcp.git
cd perplexica-mcp

# Install dependencies
uv sync

MCP Client Configuration

To use this server with MCP clients, you need to configure the client to connect to the Perplexica MCP server. Below are configuration examples for popular MCP clients.

Important: All transport modes require proper environment variable configuration, especially:

• PERPLEXICA_BACKEND_URL: URL to your Perplexica backend API
• PERPLEXICA_CHAT_MODEL_PROVIDER and PERPLEXICA_CHAT_MODEL_NAME: Chat model configuration