MAX MCP
max-mcp
Локальный MCP-сервер для мессенджера MAX от пользовательской сессии: чаты, поиск, выгрузка каналов, отправка сообщений и файлов
- 5 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Отправляет сообщения и файлы от имени вашего аккаунта
- Использует неофициальный клиент, аккаунт могут ограничить
- Сессия с доступом ко всей переписке хранится локально
Установка
- Работает в
- Сервисы
Ручная установка
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 сообщенийMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
MAX_MCP_SEND_ROOTS- Каталоги, из которых разрешено отправлять файлы, через двоеточие
Ограничения
Используется неофициальный клиент maxapi-python и пользовательская сессия, протокол MAX может измениться без предупреждения. Автор советует экспериментировать с отдельным аккаунтом. Работает на macOS и Linux с Python 3.11-3.13 и uv. Поиск идет последовательным чтением истории, большой канал выгружается за несколько вызовов.
Как отключить. Выполните claude mcp remove max-mcp, отвяжите устройство в настройках MAX и удалите сессию из ~/.max-mcp/.
Частые вопросы
Как войти без QR-кода?
Командой uv run max-mcp-login login-sms --phone с номером телефона.
Откуда можно отправлять файлы?
По умолчанию из ~/Downloads, ~/Documents и /tmp. Свой список задается переменной MAX_MCP_SEND_ROOTS.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MAX — все инструментыMCP-сервер бота Max
Max Bot MCP Server
MCP-сервер для чтения сообщений бота в мессенджере Max: чаты, участники, поиск по тексту и скачивание вложений
MCP-сервер для мессенджера MAX
mcp-max-messenger
MCP-сервер для Bot API мессенджера MAX: сообщения, медиа, чаты, участники и кнопки из агента
Удаленный MCP-сервер MaxStat для поиска и аналитики каналов и публикаций в мессенджере MAX
MCP-сервер мессенджера MAX
mcp-server-max
MCP-сервер для мессенджера MAX (бывший VK Teams): отправка и чтение сообщений, управление чатами, закреп и статус набора текста
Канал MAX для Claude Code
max-gateway
Надежный демон и плагин-мост: общайся со своей сессией Claude Code из мессенджера MAX, с фото, голосом и кнопками
MCP контент-фабрика для Telegram, VK и MAX
publish-mcp
MCP-сервер генерирует, переводит и публикует посты в Telegram, VK, MAX и Threads: бренд-профиль, анализ конкурентов и картинки одним пайплайном
Коротко о README
README на русском перечисляет восемь инструментов и сразу предупреждает о неофициальном клиенте и риске ограничений аккаунта. Описаны установка через uv, вход по QR-коду или SMS, подключение к Claude Code и примеры запросов. Отдельно разобраны правила отправки файлов и повторная авторизация, есть список ограничений и ссылки на документацию по инструментам и диагностике. Лицензия MIT.