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

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

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

perplexity_search

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

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

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

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

Получите ваш API-ключ Perplexity на портале API
Замените your_key_here в конфигурациях ниже на ваш API-ключ
(Опционально) Установите тайм-аут: PERPLEXITY_TIMEOUT_MS=600000 (по умолчанию: 5 минут)
(Опционально) Установите пользовательский базовый URL: PERPLEXITY_BASE_URL=https://your-custom-url.com (по умолчанию: https://api.perplexity.ai)
(Опционально) Установите уровень логирования: 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:

Клиент	Файл конфигурации
Cursor	`~/.cursor/mcp.json`
Claude Desktop	`claude_desktop_config.json`
Kiro	`.kiro/settings/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
VS Code	`.vscode/mcp.json`

{
  "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.

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

Переменная	Описание	По умолчанию
`PERPLEXITY_API_KEY`	Ваш API-ключ Perplexity	Обязательно
`PERPLEXITY_BASE_URL`	Пользовательский базовый URL для API-запросов	`https://api.perplexity.ai`
`PORT`	Порт HTTP-сервера	`8080`
`BIND_ADDRESS`	Сетевой интерфейс для привязки	`0.0.0.0`
`ALLOWED_ORIGINS`	Источники CORS (через запятую)	`*`

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 / Initialize: Некоторые строгие MCP-клиенты выдают ошибку, потому что npx записывает сообщения об установке в stdout. Используйте npx -yq вместо npx -y, чтобы подавить этот вывод.

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

Perplexity API MCP Server