MAX MCP
max-mcp
Локальный MCP-сервер для мессенджера MAX от пользовательской сессии: чаты, поиск, выгрузка каналов, отправка сообщений и файлов
Установка
git clone https://github.com/renosaza/max-mcp.git ~/max-mcp
cd ~/max-mcp
uv sync --frozen
uv run max-mcp-login login-qrQR-код сканируется в мобильном приложении 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.
Похожие
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети
Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском