Русский · English

perplexity-proxyapi-mcp

MCP-сервер для Claude (Claude Code и Claude Desktop): поиск в интернете и Deep Research через Perplexity (модели Sonar) по API ProxyAPI — оплата в рублях российской картой или СБП, без VPN.

Каждый ответ приходит со ссылками на источники и строкой о стоимости:

💰 Запрос: 0,42 ₽ (точно, по балансу) · модель perplexity/sonar, токены 512 → 830, 6 с · за сегодня 3,10 ₽ из 200,00 ₽ · остаток баланса 296,90 ₽

Инструменты

Фильтры поиска (необязательные): recency (hour/day/week/month/year), domains (до 20 сайтов, исключение через -), academic (научные источники), languages, after_date / before_date (ММ/ДД/ГГГГ), max_tokens.

Защита от лишних трат:

• в описании инструментов прописано, что Claude обязан спросить разрешение перед каждым платным вызовом;

• работают только модели perplexity/* — другие запрещены в коде;

• дневной лимит расходов PPLX_DAILY_BUDGET (по умолчанию 200 ₽): запрос, который может его превысить, не отправляется;

• Deep Research запрашивается потоком (stream: true): без него ProxyAPI обрывает долгий запрос примерно через 300 с и возвращает пустой ответ; пустой ответ считается ошибкой;

• у каждого режима свой лимит длины ответа — иначе ProxyAPI требует на балансе запас под максимальный ответ модели (для Deep Research это ~130 ₽);

• все вызовы с токенами и стоимостью пишутся в perplexity.log, расходы по дням — в spend.json.

⚠️ Perplexity с 27.09.2026 считает API Sonar устаревшим: запросы пока работают, но модели могут смениться. Названия моделей можно поменять переменными PPLX_MODEL_* без правки кода.

Related MCP server: perplexity-sonar-mcp

Установка

1. Скачать и установить зависимости

Нужен Node.js 20+.

git clone https://github.com/spolperim-lab/ProxyAPI-Perplexity-mcp.git
cd ProxyAPI-Perplexity-mcp
npm install

2. Ключ ProxyAPI

1. Зарегистрируйтесь на proxyapi.ru и пополните баланс (100–300 ₽ хватит на тесты).

2. «Ключи API» → «Создать новый ключ API» (ключ начинается с sk-, показывается один раз).

3. В настройках ключа рекомендуется:

   • Доступные модели — выбрать только модели Perplexity;

   • Разрешения → «Запрос баланса» — включить, тогда стоимость каждого запроса будет точной (разница баланса до и после), а не оценкой по токенам;

   • Бюджет — по желанию, ещё один предохранитель.

4. Скопируйте key.env.example в key.env и вставьте ключ в строку ProxyAPI_Key.

Один key.env можно делить с другими MCP (например, с gigachat-image-mcp): каждый сервер читает только свою строку.

⚠️ key.env — секрет. Не выкладывайте его и не пересылайте. Он уже в .gitignore.

3. Подключить к Claude

Замените C:/path/to/ProxyAPI-Perplexity-mcp на реальный путь (прямые слэши работают и в Windows).

Claude Code:

claude mcp add perplexity --scope user -e PROXYAPI_KEY_FILE=C:/path/to/key.env -e PPLX_DAILY_BUDGET=200 -- node C:/path/to/ProxyAPI-Perplexity-mcp/index.js

Чтобы Claude Code всегда спрашивал подтверждение, добавьте в ~/.claude/settings.json:

{
  "permissions": {
    "ask": ["mcp__perplexity__perplexity_search", "mcp__perplexity__perplexity_research"]
  }
}

Claude Desktop — в claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["C:/path/to/ProxyAPI-Perplexity-mcp/index.js"],
      "env": {
        "PROXYAPI_KEY_FILE": "C:/path/to/key.env",
        "PPLX_DAILY_BUDGET": "200"
      }
    }
  }
}

После правки полностью перезапустите Claude Desktop (значок в трее → «Выйти»).

Настройки

Лицензия

MIT — см. LICENSE.