MAX MCP

max-mcp

Локальный MCP-сервер для мессенджера MAX от пользовательской сессии: чаты, поиск, выгрузка каналов, отправка сообщений и файлов

MCP-серверВысокий рискРоссийский стек

renosaza/max-mcp

Установка

git clone https://github.com/renosaza/max-mcp.git ~/max-mcp
cd ~/max-mcp
uv sync --frozen
uv run max-mcp-login login-qr

QR-код сканируется в мобильном приложении MAX в разделе привязки нового устройства.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер входит в MAX как ваше устройство и дает агенту восемь инструментов. Агент видит список диалогов, групп и каналов, читает историю с пагинацией, ищет подстроку в выбранном чате и выгружает публикации каналов с реакциями, до тысячи за вызов. Он также может отправить сообщение, ответ или файл. Отправлять разрешено только файлы из заданных каталогов, пути к ключам SSH, AWS и системным каталогам заблокированы.

Для кого. SMM-специалистам и аналитикам, которые разбирают каналы и переписку в MAX.

Подходит, если

  • Нужно выгрузить публикации канала в JSON для анализа
  • Нужно найти в чате сообщения по ключевому слову
  • Нужно отправить отчет в чат прямо из рабочей сессии агента

Не подходит, если

  • Нужны массовые рассылки: это прямой путь к ограничениям аккаунта
  • Нельзя рисковать основным аккаунтом MAX

Пример запроса к агенту

Найди в чате 123456 сообщения со словом «договор», просмотрев не больше 1000 сообщений

Ограничения

Используется неофициальный клиент maxapi-python и пользовательская сессия, протокол MAX может измениться без предупреждения. Автор советует экспериментировать с отдельным аккаунтом. Работает на macOS и Linux с Python 3.11-3.13 и uv. Поиск идет последовательным чтением истории, большой канал выгружается за несколько вызовов.

Как отключить. Выполните claude mcp remove max-mcp, отвяжите устройство в настройках MAX и удалите сессию из ~/.max-mcp/.

MCP

Транспорт
stdio
Авторизация
не нужна
Переменные окружения
Переменные окружения
MAX_MCP_SEND_ROOTS
Каталоги, из которых разрешено отправлять файлы, через двоеточие

Проверка безопасности

  • Отправляет сообщения и файлы от имени вашего аккаунта
  • Использует неофициальный клиент, аккаунт могут ограничить
  • Сессия с доступом ко всей переписке хранится локально

Коротко о README

README на русском перечисляет восемь инструментов и сразу предупреждает о неофициальном клиенте и риске ограничений аккаунта. Описаны установка через uv, вход по QR-коду или SMS, подключение к Claude Code и примеры запросов. Отдельно разобраны правила отправки файлов и повторная авторизация, есть список ограничений и ссылки на документацию по инструментам и диагностике. Лицензия MIT.

Частые вопросы

Как войти без QR-кода?

Командой uv run max-mcp-login login-sms --phone с номером телефона.

Откуда можно отправлять файлы?

По умолчанию из ~/Downloads, ~/Documents и /tmp. Свой список задается переменной MAX_MCP_SEND_ROOTS.

Выбор редакции

Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов

СкиллНизкий риск

Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети

СкиллВысокий риск25,9 тыс.

Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском

СкиллНизкий риск17,3 тыс.