MCP-сервер платформы Perplexity API

Официальная реализация MCP-сервера для платформы Perplexity API, предоставляющая ИИ-ассистентам возможности поиска в реальном времени, рассуждения и исследования с помощью моделей Sonar и API поиска.

Доступные инструменты

perplexity_search

Прямой веб-поиск с использованием API поиска Perplexity. Возвращает ранжированные результаты поиска с метаданными, идеально подходит для поиска актуальной информации.

perplexity_ask

ИИ общего назначения для общения с поддержкой веб-поиска в реальном времени с использованием модели sonar-pro. Отлично подходит для быстрых вопросов и повседневного поиска.

perplexity_research

Глубокое, всестороннее исследование с использованием модели sonar-deep-research. Идеально подходит для тщательного анализа и подробных отчетов.

perplexity_reason

Продвинутое рассуждение и решение задач с использованием модели sonar-reasoning-pro. Идеально подходит для сложных аналитических задач.

[!TIP] Доступно в качестве необязательного параметра для perplexity_reason и perplexity_research: strip_thinking

Установите значение true, чтобы удалить теги <think>...</think> из ответа, экономя токены контекста. По умолчанию: false

Related MCP server: Perplexity Ask MCP Server

Конфигурация

Получите ваш API-ключ

1. Получите ваш API-ключ Perplexity на портале API

2. Замените your_key_here в конфигурациях ниже на ваш API-ключ

3. (Опционально) Установите тайм-аут: PERPLEXITY_TIMEOUT_MS=600000 (по умолчанию: 5 минут)

4. (Опционально) Установите пользовательский базовый URL: PERPLEXITY_BASE_URL=https://your-custom-url.com (по умолчанию: https://api.perplexity.ai)

5. (Опционально) Установите уровень логирования: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (по умолчанию: ERROR)

Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Или установите через плагин:

export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Cursor, Claude Desktop, Kiro, Windsurf и VS Code

Большинство клиентов можно настроить вручную, используя ту же обертку mcpServers в конфигурации клиента (как показано для Cursor). Если у клиента другая схема, проверьте его документацию для уточнения формата обертки.

Для ручной настройки все эти клиенты используют одну и ту же структуру mcpServers:

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

Настройка прокси (для корпоративных сетей)

Если вы запускаете этот сервер на работе — особенно за корпоративным брандмауэром или прокси — вам может потребоваться указать программе, как направлять интернет-трафик через прокси вашей сети. Выполните следующие шаги:

1. Получите данные вашего прокси

• Узнайте у вашего ИТ-отдела адрес и порт вашего HTTPS-прокси.

• Вам также могут потребоваться имя пользователя и пароль.

2. Установите переменную окружения прокси

Самый простой и надежный способ для Perplexity MCP — использовать PERPLEXITY_PROXY. Например:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

Если вашему прокси требуются имя пользователя и пароль, используйте:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. Альтернатива: Стандартные переменные окружения

Если вы предпочитаете использовать стандартные переменные, мы поддерживаем HTTPS_PROXY и HTTP_PROXY.

[!NOTE] Сервер проверяет настройки прокси в следующем порядке: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Если ничего не задано, он подключается напрямую к интернету. URL-адреса должны включать https://. Типичные порты: 8080, 3128 и 80.

Развертывание HTTP-сервера

Для облачных или общих развертываний запустите сервер в режиме HTTP.

Переменные окружения

Docker

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

Сервер будет доступен по адресу http://localhost:8080/mcp

Устранение неполадок

• Проблемы с API-ключом: Убедитесь, что PERPLEXITY_API_KEY установлен правильно

• Ошибки подключения: Проверьте интернет-соединение и действительность API-ключа

• Инструмент не найден: Убедитесь, что пакет установлен и путь к команде указан верно

• Ошибки тайм-аута: Для очень длинных исследовательских запросов установите PERPLEXITY_TIMEOUT_MS на более высокое значение

• Проблемы с прокси: Проверьте настройки PERPLEXITY_PROXY или HTTPS_PROXY и убедитесь, что api.perplexity.ai не заблокирован вашим брандмауэром.

• Ошибки EOF / инициализации: Некоторые строгие MCP-клиенты выдают ошибку, так как npx записывает сообщения об установке в stdout. Используйте npx -yq вместо npx -y, чтобы подавить этот вывод.

Для получения поддержки посетите community.perplexity.ai или создайте тикет.