perplexity-mcp-server

MCP-сервер для структурированных рабочих процессов конкурентной/рыночной разведки на основе Perplexity Sonar API.

Исправление (2026-08-26): в более ранней версии этого README утверждалось, что нативного MCP-коннектора Perplexity нигде не существует. Это было неверно — Perplexity публикует официальный MCP-сервер (github.com/perplexityai/modelcontextprotocol), включая размещённый Perplexity удалённый endpoint на https://api.perplexity.ai/mcp, доступный из облачной сессии по расписанию без какого-либо самостоятельного хостинга. Если вам нужен просто универсальный разовый поиск через Sonar, зарегистрируйте его вместо того, чтобы собирать или запускать что-то здесь.

Чего официальный сервер не даёт — это структурированного, сопоставимого еженедельного мониторинга: он предоставляет универсальный поиск/рассуждение (Agent API, Search API), а не бриф по компании с фиксированными разделами и не обзор сигналов, ограниченный JSON-схемой. Именно в этом настоящая причина существования этого сервера — это тонкий, узкий слой из двух инструментов рабочего процесса, а не замена собственному MCP-серверу Perplexity.

Разверните это один раз (см. раздел «Удалённое развёртывание» ниже), задав PERPLEXITY_API_KEY как секрет платформы, и любой MCP-клиент — включая облачную сессию Cowork/Claude, запускаемую по расписанию, — сможет вызывать его по HTTP, вообще не касаясь локальной машины или моста устройств. Регистрируйте его наряду с официальным сервером Perplexity, а не вместо него.

Инструменты

• perplexity_company_news — структурированный бриф новостей компании (управление, руководители, стратегические события, финансовое положение, кадровые изменения), фиксированные заголовки разделов, lookback_days вместо произвольных диапазонов дат.

• perplexity_market_signals — обзор сигналов по всему сектору (M&A, финансирование, назначения, реструктуризации), ограниченный JSON-схемой на стороне сервера, так что результат — это настоящий массив отдельных сигналов, а не markdown, который нужно повторно парсить. Возвращает пустой массив (не ошибку), когда за период не найдено ничего датированного и надёжного, — это значимый результат, а не сбой.

Оба инструмента поддерживают response_format: "markdown" | "json" и возвращают цитаты/источники. Для поиска общего назначения используйте официальный MCP-сервер Perplexity — см. исправление выше.

Related MCP server: Stelar Signals MCP

Настройка

npm install
cp .env.example .env   # then set PERPLEXITY_API_KEY
npm run build

Локальное использование (stdio) — быстрый старт, не решает проблему облачных задач по расписанию

Подходит для тестирования или для любого рабочего процесса, который уже выполняется на вашей собственной машине. Зарегистрируйте его в конфигурации вашего MCP-клиента (например, в claude_desktop_config.json для Claude Desktop):

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["/absolute/path/to/perplexity-mcp-server/dist/index.js"],
      "env": { "PERPLEXITY_API_KEY": "pplx-..." }
    }
  }
}

Это по-прежнему привязывает доступность к тому, что эта машина включена, — это не решает исходную проблему задачи, запускаемой в облаке по расписанию, которой нужен ключ. Для этого используйте HTTP-развёртывание ниже.

Удалённое развёртывание (streamable HTTP) — настоящее решение для облачных задач по расписанию

Запустите тот же код с TRANSPORT=http на любом хосте, поддерживающем Node (небольшой VPS, Render, Railway, Fly.io, контейнер у любого облачного провайдера). Единственные требования: Node 18+, возможность задать секрет в переменной окружения и публичный HTTPS-URL.

PERPLEXITY_API_KEY=pplx-... TRANSPORT=http PORT=3000 npm start

Сервер предоставляет:

• POST /mcp — MCP endpoint (streamable HTTP, JSON без состояния — новый сервер+транспорт на каждый запрос, поэтому ничего не протекает между вызовами, и он горизонтально масштабируется без общего состояния)

• GET /health — простая проверка живости (liveness) для health-пробы вашей хостинг-платформы

После развёртывания за HTTPS (https://your-host/mcp) зарегистрируйте этот URL как удалённый MCP-коннектор в рабочем пространстве, чтобы задача, зависящая от Perplexity, могла обращаться к нему напрямую, а ключ хранился на стороне сервера, — та же операционная модель, которую уже использует Pappers (нативный коннектор, без локального секрета в пути доступа к учётным данным).

Что было проверено в этой сборке

• npm run build компилируется без ошибок (строгий TypeScript, без any).

• Оба транспорта запускаются без падений (stdio и HTTP).

• GET /health отвечает корректно.

• Полное MCP-рукопожатие (initialize, tools/list) возвращает оба инструмента с корректными JSON-схемами, описаниями и аннотациями.

• tools/call с недействительным API-ключом возвращает чистый, информативный результат isError: true (указание на 401, ведущее к дашборду Perplexity), — сервер не падает и остаётся отзывчивым после этого.

Что ещё не проверено

В среде сборки не было настоящего PERPLEXITY_API_KEY, поэтому реальный успешный вызов Sonar — настоящее содержимое ответа, настоящие цитаты, ответ market_signals с ограничением по JSON-схеме, который действительно разбирается как валидный JSON, — не был проверен насквозь (end-to-end). Прежде чем полагаться на это в рабочей процедуре мониторинга, запустите каждый из двух инструментов по одному разу с реальным ключом (локально через stdio для этой проверки достаточно) и убедитесь, что вывод соответствует формам, описанным выше.

Примечание о стоимости

perplexity_company_news и perplexity_market_signals по умолчанию используют модель sonar-pro (более глубокий поиск, больше источников, выше стоимость за вызов, чем у sonar), потому что сценарий мониторинга ставит полноту и качество цитирования выше задержки/стоимости — это намеренное значение по умолчанию для обоих инструментов этого сервера, подтверждено 2026-08-26. Здесь нет инструмента perplexity_search, чтобы выбрать более дешёвую модель для разовых запросов; для этого используйте официальный MCP-сервер Perplexity (см. исправление в начале этого файла). Изучите текущие цены Perplexity по моделям, прежде чем запускать это в масштабе еженедельной рутины для десятков компаний, — полный прогон обогащает порядка 50–90 компаний плюс один обзор рыночных сигналов, так что предельная стоимость sonar-pro по сравнению с sonar быстро накапливается.