MCP-сервер бота Max

Max Bot MCP Server

MCP-сервер для чтения сообщений бота в мессенджере Max: чаты, участники, поиск по тексту и скачивание вложений

  • 1 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Читает личные сообщения и вложения из всех чатов, доступных боту
  • Токен бота дает полный доступ к переписке до отзыва
Все причины и проверки
Российский стек

ammite/max_bot_messages_parsing

Установка

Сервисы

Ручная установка

claude mcp add max-bot -- env MAX_BOT_TOKEN=ваш_токен_бота python server.py

Команда из README, требует предварительно pip install -r requirements.txt.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Читает личные сообщения и вложения из всех чатов, доступных боту
  • Токен бота дает полный доступ к переписке до отзыва

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

Что делает

Сервер оборачивает Max Bot API в шесть инструментов только для чтения: список чатов бота, участники конкретного чата, сообщения с фильтром по датам и пагинацией, поиск по тексту без учета регистра, скачивание аудио и любых файлов-вложений. Отправлять сообщения от имени бота сервер не умеет. Количество сканируемых при поиске сообщений ограничено по умолчанию 5000, все HTTP-запросы к Max имеют таймаут, а скачивание файлов защищено от выхода за пределы каталога загрузок.

Для кого. Для разработчиков, которые уже завели бота в Max и хотят дать Claude Code доступ к его переписке для анализа и поиска.

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

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

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

  • Нужно отправлять сообщения или отвечать от имени бота: сервер только читает
  • Нужен доступ к личному аккаунту Max, а не к боту

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

Найди сообщения со словом отчет в чате 12345 за последнюю неделю

MCP

Транспорт
stdio
Авторизация
API-ключ

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

MAX_BOT_TOKEN обязательная, секрет
Токен бота Max, выдается через @MasterBot

Ограничения

Проект совсем маленький: один файл server.py, 1 звезда, автор один. Нет ни установки как npm или pip пакета, ни тестов. Нужен собственный бот Max с токеном, полученным через @MasterBot.

Как отключить. Удалите сервер командой claude mcp remove max-bot и отзовите токен бота через @MasterBot при необходимости.

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

Может ли сервер отправить сообщение от бота?

Нет, все инструменты только читают чаты, участников и сообщения.

Сколько сообщений просматривает поиск?

По умолчанию до 5000 сообщений на чат, это ограничение задано в коде сервера.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

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

MCP-серверРасширенный доступ12Звезды репозитория
Российский стек

MCP-сервер для мессенджера MAX (бывший VK Teams): отправка и чтение сообщений, управление чатами, закреп и статус набора текста

MCP-серверШирокий доступ

MAX MCP

max-mcp

Российский стек

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

MCP-серверШирокий доступ6Звезды репозитория
Официальный

Удаленный MCP-сервер MaxStat для поиска и аналитики каналов и публикаций в мессенджере MAX

MCP-серверРасширенный доступ3Звезды репозитория
Российский стек

Канал-плагин, который подключает AI-ассистента OpenClaw к мессенджеру MAX через официальный Bot API: текст, медиа, кнопки, стриминг, мультиаккаунт

ПлагинРасширенный доступ
Российский стек

Набор упрощенных примеров на Python, из которых можно собрать личного AI-секретаря в мессенджере MAX через Bot API, User API и MCP

ВоркфлоуШирокий доступ2Звезды репозитория

Коротко о README

Короткий README на русском описывает шесть инструментов, установку через pip install -r requirements.txt и подключение командой claude mcp add с переменной MAX_BOT_TOKEN. Отдельный раздел безопасности упоминает передачу токена только через переменную окружения, защиту от path traversal при скачивании файлов, лимит сканируемых сообщений и таймауты запросов.

Бейдж для README

Сообщить о проблеме