{
  "markdown": "# Perplexity MCP Server via Polza.ai\n\n`mcp-name: io.github.ivanantigravity-lgtm/perplexity-polza-mcp-server`\n\nMCP сервер для `Claude Desktop` и `Claude Code`, который ходит в модели Perplexity (`Sonar`, `Sonar Pro`, `Sonar Reasoning`, `Sonar Deep Research`) через агрегатор [Polza.ai](https://polza.ai).\n\n## Что умеет\n\n- `perplexity_model_guide` — шпаргалка по выбору модели под задачу\n- `perplexity_ask` — обычный вопрос в Perplexity\n- `perplexity_research` — более глубокий ресёрч с веб-поиском\n- `list_perplexity_models` — список доступных `perplexity/*` моделей из каталога Polza\n\n## Что нужно для установки\n\n- `Claude Desktop` или `Claude Code` (или любой другой MCP-клиент)\n- [`uv`](https://docs.astral.sh/uv/) (ставится одной командой, см. ниже)\n- Python 3.11+\n- `POLZA_AI_API_KEY` — ключ берётся на [polza.ai/dashboard/api-keys](https://polza.ai/dashboard/api-keys)\n\nПоставить `uv`:\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n## Установка за 2 минуты (через PyPI + uvx)\n\nЭто самый простой путь: ничего клонировать не надо, `uvx` сам скачает пакет из PyPI.\n\n### Claude Code / VS Code\n\nСоздай файл `.mcp.json` в корне своего проекта:\n\n```json\n{\n  \"mcpServers\": {\n    \"perplexity-polza\": {\n      \"command\": \"uvx\",\n      \"args\": [\"perplexity-polza-mcp-server@latest\"],\n      \"env\": {\n        \"POLZA_AI_API_KEY\": \"your-polza-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nПерезапусти Claude Code — готово.\n\n### Claude Desktop (macOS)\n\nОткрой файл `~/Library/Application Support/Claude/claude_desktop_config.json` и добавь:\n\n```json\n{\n  \"mcpServers\": {\n    \"perplexity-polza\": {\n      \"command\": \"uvx\",\n      \"args\": [\"perplexity-polza-mcp-server@latest\"],\n      \"env\": {\n        \"POLZA_AI_API_KEY\": \"your-polza-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nПерезапусти Claude Desktop.\n\n### Claude Desktop (Windows)\n\nФайл: `%APPDATA%\\Claude\\claude_desktop_config.json`. Содержимое такое же, как на macOS.\n\n## Как проверить, что работает\n\nПосле перезапуска Claude попроси:\n\n> Покажи доступные модели Perplexity через polza\n\nClaude должен вызвать tool `list_perplexity_models` и вернуть список.\n\n## Когда какую модель брать\n\n- `Sonar` — быстрый поиск + ответ. Новости, факты, Q&A, короткие суммаризации.\n- `Sonar Pro` — плотнее структура, сравнения, follow-up вопросы.\n- `Sonar Pro Search` — глубже поиск, больше поисковых шагов.\n- `Sonar Reasoning Pro` — не просто найти, а разобрать и сделать вывод.\n- `Sonar Deep Research` — полноценный ресёрч, market scan, длинный отчёт.\n\nПереключить дефолтную модель можно через переменные окружения `PERPLEXITY_MODEL` и `PERPLEXITY_RESEARCH_MODEL` — полный список ниже.\n\n## Переменные окружения\n\n| Переменная | Обязательная | По умолчанию | Описание |\n| --- | --- | --- | --- |\n| `POLZA_AI_API_KEY` | да | — | Ключ с polza.ai |\n| `POLZA_BASE_URL` | нет | `https://polza.ai/api/v1` | Base URL для chat completions (с `/v1` — это ожидаемо, endpoint OpenAI-совместим) |\n| `PERPLEXITY_MODEL` | нет | `perplexity/sonar` | Модель для `perplexity_ask` |\n| `PERPLEXITY_RESEARCH_MODEL` | нет | `perplexity/sonar-deep-research` | Модель для `perplexity_research` |\n| `LOG_LEVEL` | нет | `INFO` | — |\n\n## Локальная разработка\n\n```bash\ngit clone https://github.com/ivanantigravity-lgtm/perplexity-polza-mcp-server.git\ncd perplexity-polza-mcp-server\nuv sync\nPOLZA_AI_API_KEY=your_key uv run python -m perplexity_polza_mcp_server.server\n```\n\nДля локального подключения из source в Claude:\n\n```json\n{\n  \"mcpServers\": {\n    \"perplexity-polza-local\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"python\", \"-m\", \"perplexity_polza_mcp_server.server\"],\n      \"cwd\": \"/absolute/path/to/perplexity-polza-mcp-server\",\n      \"env\": {\n        \"POLZA_AI_API_KEY\": \"your-polza-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Под капотом\n\n- Chat completions: `POST https://polza.ai/api/v1/chat/completions` (OpenAI-совместимый формат)\n- Model catalog: `GET https://polza.ai/api/v1/models/catalog`\n\n## Важные файлы в репозитории\n\n- `pyproject.toml` — метаданные пакета и entry points\n- `server.json` — описание для MCP Registry\n- `fastmcp.json` — локальная конфигурация FastMCP\n- `.github/workflows/publish-pypi.yml` — публикация в PyPI через GitHub Actions\n\n## Лицензия\n\nMIT.\n",
  "bytes": 4189,
  "sha": "a3fc92fd015fd39d2afe121d47dae774eea9c83b2f6abd6bd78611492093f7b6",
  "repo_slug": "ivanantigravity-lgtm/perplexity-polza-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ivanantigravity_lgtm_perplexit_5b49a2e6/readme"
}