Skip to main content
Glama
perplexity-polza-mcp-server

perplexity-polza-mcp-server

Perplexity MCP Server via Polza.ai

mcp-name: io.github.ivanantigravity-lgtm/perplexity-polza-mcp-server

MCP сервер для Claude Desktop и Claude Code, который ходит в модели Perplexity (Sonar, Sonar Pro, Sonar Reasoning, Sonar Deep Research) через агрегатор Polza.ai.

Что умеет

  • perplexity_model_guide — шпаргалка по выбору модели под задачу

  • perplexity_ask — обычный вопрос в Perplexity

  • perplexity_research — более глубокий ресёрч с веб-поиском

  • list_perplexity_models — список доступных perplexity/* моделей из каталога Polza

Related MCP server: Perplexity Agent MCP

Что нужно для установки

  • Claude Desktop или Claude Code (или любой другой MCP-клиент)

  • uv (ставится одной командой, см. ниже)

  • Python 3.11+

  • POLZA_AI_API_KEY — ключ берётся на polza.ai/dashboard/api-keys

Поставить uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Установка за 2 минуты (через PyPI + uvx)

Это самый простой путь: ничего клонировать не надо, uvx сам скачает пакет из PyPI.

Claude Code / VS Code

Создай файл .mcp.json в корне своего проекта:

{
  "mcpServers": {
    "perplexity-polza": {
      "command": "uvx",
      "args": ["perplexity-polza-mcp-server@latest"],
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

Перезапусти Claude Code — готово.

Claude Desktop (macOS)

Открой файл ~/Library/Application Support/Claude/claude_desktop_config.json и добавь:

{
  "mcpServers": {
    "perplexity-polza": {
      "command": "uvx",
      "args": ["perplexity-polza-mcp-server@latest"],
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

Перезапусти Claude Desktop.

Claude Desktop (Windows)

Файл: %APPDATA%\Claude\claude_desktop_config.json. Содержимое такое же, как на macOS.

Как проверить, что работает

После перезапуска Claude попроси:

Покажи доступные модели Perplexity через polza

Claude должен вызвать tool list_perplexity_models и вернуть список.

Когда какую модель брать

  • Sonar — быстрый поиск + ответ. Новости, факты, Q&A, короткие суммаризации.

  • Sonar Pro — плотнее структура, сравнения, follow-up вопросы.

  • Sonar Pro Search — глубже поиск, больше поисковых шагов.

  • Sonar Reasoning Pro — не просто найти, а разобрать и сделать вывод.

  • Sonar Deep Research — полноценный ресёрч, market scan, длинный отчёт.

Переключить дефолтную модель можно через переменные окружения PERPLEXITY_MODEL и PERPLEXITY_RESEARCH_MODEL — полный список ниже.

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

Переменная

Обязательная

По умолчанию

Описание

POLZA_AI_API_KEY

да

—

Ключ с polza.ai

POLZA_BASE_URL

нет

https://polza.ai/api/v1

Base URL для chat completions (с /v1 — это ожидаемо, endpoint OpenAI-совместим)

PERPLEXITY_MODEL

нет

perplexity/sonar

Модель для perplexity_ask

PERPLEXITY_RESEARCH_MODEL

нет

perplexity/sonar-deep-research

Модель для perplexity_research

LOG_LEVEL

нет

INFO

—

Локальная разработка

git clone https://github.com/ivanantigravity-lgtm/perplexity-polza-mcp-server.git
cd perplexity-polza-mcp-server
uv sync
POLZA_AI_API_KEY=your_key uv run python -m perplexity_polza_mcp_server.server

Для локального подключения из source в Claude:

{
  "mcpServers": {
    "perplexity-polza-local": {
      "command": "uv",
      "args": ["run", "python", "-m", "perplexity_polza_mcp_server.server"],
      "cwd": "/absolute/path/to/perplexity-polza-mcp-server",
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

Под капотом

  • Chat completions: POST https://polza.ai/api/v1/chat/completions (OpenAI-совместимый формат)

  • Model catalog: GET https://polza.ai/api/v1/models/catalog

Важные файлы в репозитории

  • pyproject.toml — метаданные пакета и entry points

  • server.json — описание для MCP Registry

  • fastmcp.json — локальная конфигурация FastMCP

  • .github/workflows/publish-pypi.yml — публикация в PyPI через GitHub Actions

Лицензия

MIT.

Available Tools

3 tools
list_perplexity_modelsD

Inputs: include_providers.

perplexity_askD

Inputs: prompt (required), model, system, temperature, +4 more.

perplexity_researchD

Inputs: topic (required), model, system, max_tokens, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.6/5.0

    Scored across 3 tools

    Disambiguation4/5

    Tool names suggest distinct purposes: listing models, asking a question, and doing research. However, the lack of descriptions creates some ambiguity about each tool's exact scope.

    Naming Consistency2/5

    Naming is inconsistent: one tool uses a verb_noun pattern (list_perplexity_models), while the other two use a brand prefix followed by a verb (perplexity_ask, perplexity_research). The convention is not uniform.

    Tool Count3/5

    Three tools is on the lower side but could be sufficient for a focused server (e.g., listing models, asking questions, researching). However, the lack of descriptions makes the scope feel underdeveloped.

    Completeness3/5

    The tool set covers basic interactions with Perplexity (list models, ask, research), but without descriptions it's unclear if common operations like context management or follow-up questions are supported. The surface appears minimal but possibly complete for simple use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI-powered search, research, and reasoning capabilities through integration with Perplexity.ai, offering three specialized tools: general conversational AI, deep research with citations, and advanced reasoning.
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables coding assistants to access Perplexity AI for quick fact-checking and in-depth research. Provides two tools: lookup for fast documentation queries and answer for comprehensive research with recommendations.
      2
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI-powered web research using your existing Perplexity Pro subscription, providing tools for search, follow-up conversations, and thread management through the Model Context Protocol.
      4
      1,201 PyPI
      24
      MIT
    • A
      license
      C
      quality
      A
      maintenance
      Enables AI agents and users to query Perplexity AI's premium models (GPT-5.4, Claude 4.6 Opus, Gemini 3.1 Pro, etc.) via MCP tools, CLI, or API, with support for deep research, model council, and multi-turn conversations.
      34
      406 PyPI
      211
      MIT