MAXアカウントやボットを通じて、AIクライアントがメッセージの読み取り、検索、送信を行えるようにします。
別名 WireCatLabs/max-cli, max-cli, @wirecat/max-cli
- スター
- 13
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.115.0
- 最終コミット
- 2026年11月14日
- ライセンス
- Apache-2.0
WireCat MAX MCPとは
WireCat MAXはMCPサーバーです。 MAXアカウントやボットを通じて、AIクライアントがメッセージの読み取り、検索、送信を行えるようにします。.
プロジェクトのREADMEから生成された概要
WireCat MAX MCP server について
WireCat MAXは、MAXアカウントやボットとAIエージェントを橋渡しするツールです。メッセージ履歴、チャット、連絡先をClaude Code、Cursor、Gemini CLIなどのツールに統合できます。このサーバーは、ターミナル経由でローカルで使用するか、Claude Desktopなどのデスクトップクライアント用のMCP serverとして使用できます。セットアップは、MAXアプリでのQRコードスキャンまたはSMS経由で行い、CLIをアカウントの追加デバイスとして動作させます。
このツールは、メッセージングタスクの自動化や、AIによる会話の要約を行いたい開発者やパワーユーザー向けに設計されています。高速なオフライン検索のために通信内容のローカルコピーを保持し、音声メッセージの文字起こし機能も備えています。グループやファイルを含むアカウントへのフルアクセスをサポートしていますが、意図しない操作を防ぐために、読み取り専用プロファイルやメッセージ制限などの安全機能が組み込まれています。ユーザーは、非公式APIを通じて個人アカウントとやり取りするか、標準のBot APIを通じて公式ボットを管理するかを選択できます。
できること
- 1最近の決定事項を要約するAIエージェントに最近のチャットを確認させ、他のユーザーに対してどのような約束をしたかを見つけ出します。
- 2メッセージ履歴をオフラインで検索するインターネット接続がなくても、チャット履歴から素早く検索を実行できます。
- 3音声メッセージを文字起こしする受信したボイスノートをローカル環境でテキストに変換し、読みやすくします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
WireCat MAX MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにWireCat MAX MCPをインストール
$ claude mcp add max-cli -- npx -y @wirecat/max-cliCursorにWireCat MAX MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}VS CodeにWireCat MAX MCPをインストール
.vscode/mcp.json
{
"servers": {
"max-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}VS Code CLIにWireCat MAX MCPをインストール
$ code --add-mcp '{"name":"max-cli","type":"stdio","command":"npx","args":["-y","@wirecat/max-cli"]}'Claude DesktopにWireCat MAX MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}CodexにWireCat MAX MCPをインストール
$ codex mcp add max-cli -- npx -y @wirecat/max-cliCodex config.tomlにWireCat MAX MCPをインストール
~/.codex/config.toml
[mcp_servers.max-cli] command = "npx" args = ["-y", "@wirecat/max-cli"]
Gemini CLIにWireCat MAX MCPをインストール
$ gemini mcp add -s user max-cli npx -- -y @wirecat/max-cliGemini settings.jsonにWireCat MAX MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている未チェック
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るMAX CLI для людей, ботов и агентов
Ваш аккаунт и ваши боты MAX — в терминале и в ИИ-агентах. Читайте, ищите и отвечайте сами или поручите это Claude, Codex и Cursor — по вашим правилам.
Документация · Примеры · WireCat
Пример разговора с агентом (люди и чаты вымышленные):
Вы: Что я кому обещал за последние три дня?
Агент: (вызывает max personal review: 12 чатов, 3 голосовых расшифровано)
Я должен
· Алисе Пример — прислать счёт до пятницы. Личный чат, 24.09
Жду от других
· Борис Образцов — макет к 25.09. В группе «Дизайн» его пока нет
Нужно уточнить
· «Проект Альфа»: кто везёт образцы — договорились «потом решим», 25.09
Вы: Напомни Борису про макет.
Агент: Черновик: «Борис, привет! Как там макет?» Отправить?
Вы: Да.
Быстрый старт
npm install -g @wirecat/max-cli
max skill install --for all # навык для Claude Code, Codex и Gemini CLI
max personal setup # вход по QR-коду
max personal inbox # непрочитанное во всех чатах, ничего не отмечая
max personal setup за пять минут проводит через вход: вы сканируете QR-код в приложении MAX, и max
становится ещё одним вашим устройством. Навык можно поставить и самим setup: --agent claude, codex,
cursor, gemini, all или none. Войти можно и по SMS через web.max.ru — max personal setup --help.
Нужен Node 22.16+ (ветка 22.x) или 24+, либо Bun 1.3+; работает в Windows, macOS и Linux.
Попробовать без установки — npx @wirecat/max-cli --help. Если max не находится,
npx @wirecat/max-cli personal doctor скажет почему (personal — имя профиля, которое вы выбрали; у вас оно может быть другим).
Глобальная установка (npm install -g) навык агента не ставит: его ставит max personal setup или max skill install --for all. MAX_INSTALL_AGENT=all при установке ставит его сразу, в ~/.claude/skills и ~/.agents/skills, если npm запускает сценарий установки. npm 11.17 и новее по умолчанию его не запускает и пишет об этом (allow-scripts) — это безвредно. В Windows, если max не находится, откройте новый терминал или выполните восстановление из установки.
Подробнее: установка (wirecat.dev), вход и профили (wirecat.dev).
Что можно сделать
Разобрать, что пришло. «Используй max CLI: кто ждёт моего ответа и что срочно?»
max personal inbox
Найти что угодно. «Когда мы договорились о встрече с Алисой?» — ответ с датой и самим сообщением, по локальной копии и без запросов к MAX.
max personal search messages "встреча Алиса"
Понять, кто кому что должен. «Что я обещал и чего жду от других?» — вся переписка с прошлого обзора, ваши сообщения и голосовые текстом.
max personal review 'date>3d' --transcribe
Ещё: сводки утром и вечером, итог недели по рабочему чату, кому вы обещали ответить, черновики ответов, которые отправляете вы или агент с вашего разрешения.
Подробнее: рецепты для агентов (wirecat.dev).
Для ИИ-агентов
Ваш агент. Ваш MAX. Ваши правила.
- Агент с терминалом — Claude Code, Codex, Cursor, Gemini CLI. Он сам вызывает
max, а навык (skill) — инструкция для агента — объясняет ему команды и ограничения.max personal setupставит навык сам; отдельно —max skill install. - Приложение без терминала — Claude Desktop, Cursor и другие клиенты MCP. Подключите
MCP-сервер
max personal mcp serve; готовые просьбы/catch-up,/review,/replyи/findуже внутри. - ChatGPT или Claude в браузере — через HTTPS-туннель и вход по коду.
max personal mcp add claude-code # или codex
max personal mcp config # запись для Claude Desktop, Cursor и других
Профиль по умолчанию может отправлять, поэтому mcp add сначала останавливается. Проверьте права
профиля и повторите команду с --allow-writes.
С --json каждая команда отдаёт только данные, а ошибка приходит отдельно, с постоянным кодом
завершения.
Подробнее: MCP-сервер (wirecat.dev), браузер (wirecat.dev), контракт для скриптов (wirecat.dev).
Почему max
- Весь аккаунт, а не только бот. Чаты, история, группы, контакты, файлы и голосовые — почти всё, что умеет приложение; кружков и настройки пароля двухэтапной проверки пока нет. И отдельно бот через официальный Bot API.
- Своя копия переписки. Всё прочитанное хранится на вашем компьютере: быстрый поиск и чтение
без интернета (
--offline), выгрузка в JSONL или Markdown. - Сделан для агентов. Навык, MCP-сервер, одна форма JSON и коды ошибок, по которым скрипт решает, что делать дальше.
- Безопасен по умолчанию. Чтение не ставит отметку «прочитано». Есть профиль только для чтения,
список чатов для записи и лимит сообщений в час. Если имя подходит к двум чатам,
maxне выбирает сам. Если связь оборвалась при отправке,maxтак и скажет, а повтор не создаст второе сообщение. - Порядок в группах, которые вы ведёте. Вопросы без ответа, кто вступил, проверка по вашим правилам: спам, чужие ссылки, флуд. По умолчанию проверка только отмечает.
Чем отличается от других
Для MAX есть и другие хорошие проекты; PyMax — самая полная библиотека для личного аккаунта, и её код помог разобрать протокол. Коротко, для личного аккаунта:
| max-cli | PyMax | max-mcp | |
|---|---|---|---|
| что это | программа и MCP-сервер | библиотека на Python | MCP-сервер на PyMax |
| готовые команды, навык и MCP для агентов | ✅ | — | MCP |
| ограничения для агента: только чтение, список чатов, лимит в час | ✅ | — | — |
| локальная копия с поиском без интернета | ✅ | — | — |
| расшифровка голосовых на вашем компьютере | ✅ | — | — |
| реакции, правка, пересылка, опросы, отложенная отправка | ✅ | ✅ | — |
| для админа группы: вопросы без ответа, проверка по правилам | ✅ | — | — |
Подробнее: полная таблица (wirecat.dev). Сравнение с другими инструментами MAX: сравнение (wirecat.dev).
Личный аккаунт
max без слова bot работает с вашим аккаунтом как ещё одно ваше устройство.
⚠️ Для личного аккаунта max-cli использует неофициальный внутренний API MAX. API может измениться без предупреждения, а использование инструмента может нарушать условия сервиса. Вы используете max-cli на свой риск; авторы и контрибьюторы не несут ответственности за блокировки аккаунтов, потерю данных или другие последствия. Бот работает через официальный API, и к нему это не относится.
- Читать. Чаты, история, сообщение вместе с соседними, непрочитанное во всех чатах (
max personal inbox), разбор «кто кому должен» (max personal review), новые сообщения по мере прихода (max personal watch), вложения, голосовые — текстом на вашем компьютере. - Писать. Текст и разметка, ответы, фото, видео, файлы и голосовые, правка, пересылка, закрепление, реакции, опросы, отложенная отправка, удаление — у себя или у всех.
- Группы и каналы. Создать, вступить по ссылке, выйти, участники и админы, настройки, ссылка-приглашение, папки.
- Контакты и аккаунт. Найти по номеру, добавить, переименовать, заблокировать, свои заметки о людях; профиль и фото; другие сеансы.
max personal inbox # непрочитанное, ничего не отмечая
max personal messages list "Алиса Пример" --limit 20
max personal messages send "Алиса Пример" "Созвонимся в 15:00?" --reply-to <id>
max personal reactions add "Алиса Пример" <id> 👍
max personal messages send 0 "Позвонить Борису" --at-time 2h # напоминание себе в «Избранное»
max personal chats mark-read "Алиса Пример" # отметить прочитанным, когда нужно
Подробнее: личный аккаунт (wirecat.dev), один человек (wirecat.dev), ответы (wirecat.dev).
Бот
max sales bot работает через официальный Bot API MAX по токену бота.
Ботов может быть несколько: каждый хранится под именем, которое вы выбираете, и это имя — первое
слово команды. Бота создают на business.max.ru; MAX выдаёт их
подтверждённым организациям, ИП и самозанятым.
max sales bot auth set # токен — в скрытом вводе, MAX его проверит
max sales bot recipients add "Команда продаж" # писать только сюда
max sales bot messages send "Команда продаж" "**Сборка готова**" --md --file report.pdf
max sales bot messages pin "Команда продаж" <mid> # id сообщения — из ответа на send
max sales bot watch --events # всё, что происходит в чатах бота
max sales bot chats moderate "Команда продаж" --dry-run # что нарушает правила — без действий
max sales bot api get-updates --limit 10 # любой метод Bot API
max sales bot list --check # все боты на этом компьютере
- Полный Bot API. Каждый метод официальной схемы —
max <бот> bot api <операция>: параметры — флаги, тело — JSON, который сверяется со схемой до отправки. - Сообщения и чаты. Чат называют по номеру, по названию, если бот его видел, или человека как
user:<номер>. Файлы, участники, комментарии, кнопки, меню команд, вебхуки. - Модерация.
bot chats rulesиbot chats moderateудаляют спам и людей по вашим правилам. - Копия переписки бота.
bot contacts show,bot search messages --from,bot messages between— без запросов к MAX. - Бот не напишет лишнего. Свой список чатов для записи, журнал отправленного без текста,
permissionsи MCP-серверmax <бот> bot mcp serve. Токен — в системном хранилище паролей, отдельно от вашего.
Подробнее: бот MAX (wirecat.dev).
Группы, которые вы ведёте
max personal review chat:"Поход" --unanswered # вопросы, на которые сутки никто не ответил
max personal chats events "Поход" # кто вступил и вышел
max personal chats members list "Поход" --all # все участники: когда заведён аккаунт
max personal chats rules set "Поход" invites delete # приглашения в чужие чаты — удалять
max personal chats moderate "Поход" --dry-run # что нарушает правила — без действий
Проверка сверяет новое в группе с вашими правилами: заблокированные люди, приглашения, ссылки, пересланное, флуд, совсем новые аккаунты. По умолчанию она только отмечает. Для каждого действия вы решаете сами: никогда, только с флагом, с вашим подтверждением или сразу. Не больше 10 действий за раз, и ничего не следит за группой в фоне.
Подробнее: группы (wirecat.dev), рейтинги (wirecat.dev).
Локальная копия и поиск
Всё прочитанное сохраняется на вашем компьютере. По копии работают поиск и чтение без интернета; историю чата можно скачать глубже и выгрузить.
max personal search messages "договор" # только сообщения
max personal search all "договор" # шире, по просьбе: и заметки (для почты есть отдельный CLI memo)
max personal search messages 'договор chat:"Проект Альфа"' # только один чат
max personal messages sync "Проект Альфа" --last 500 # последние 500 сообщений — в копию
max personal store export "Проект Альфа" --format markdown --output alfa.md
max personal chats list --offline # без подключения к MAX
Поиск понимает слова, людей, даты, файлы, ссылки и ваши метки; есть поиск по темам и сохранённые
запросы. Текст из сохранённых вложений ищется через content:.
Подробнее: локальная копия (wirecat.dev), поиск (wirecat.dev), язык запросов (wirecat.dev), поиск по темам (wirecat.dev), вложения (wirecat.dev), голосовые (wirecat.dev).
Агенты: навык и MCP
Навык ставится одной командой и всегда той же версии, что и max: в ~/.claude/skills/max-cli/
для Claude Code и в ~/.agents/skills/max-cli/ для Codex, Gemini CLI и Cursor. После обновления
max запустите установку ещё раз.
max skill show # прочитать до входа
max skill install --for all # или --for claude, --for agents
MCP-сервер работает с тем же аккаунтом. Права профиля проверяются при каждом вызове; формы
подтверждения на сервере нет — подтверждение вызовов настраивается в приложении агента. Навык
доступен ресурсом max://skill.
max personal mcp check # проверить локальный MCP
max personal mcp serve --http --public-url https://<имя>.ts.net # для ChatGPT и Claude в браузере
max personal mcp serve --permission messages.send=deny # запретить отправку этому серверу
Подробнее: MCP-сервер (wirecat.dev), браузер (wirecat.dev), внешние модели (wirecat.dev).
Для скриптов
С --json команда печатает только данные; так же она работает, когда её вывод читает другая
программа (max … | jq). Любой список приходит в одной форме:
{ "items": [ … ], "page": { "limit": 20, "has_more": true }, "meta": { … } }
Ошибка приходит одной строкой JSON в stderr, stdout остаётся пустым. Код завершения говорит, что
случилось: 4 — нужно войти, 5 — права не разрешают, 6 — чат или сообщение не найдены, 8 —
лимит, 9 — MAX не ответил вовремя, 14 — неизвестно, ушло ли сообщение (повторять только с тем же
--operation-id). Частичный результат может прийти с кодом 0: проверьте поля missing и next.
Подробнее: контракт (wirecat.dev), все команды и коды (wirecat.dev).
Вход и профили
max personal setup --agent codex # QR-код в терминале и навык Codex
max personal setup --method qr-chrome # QR через web.max.ru в браузере
max personal setup --method sms # номер телефона — в браузере
max personal setup --method token # готовый токен, скрытым вводом или через stdin
max personal session start qr # повторный вход, когда сессия истекла
Профиль называется первым словом в каждой команде — max personal chats list, — или
export MAX_PROFILE=personal на всю сессию оболочки. max никогда не выбирает профиль сам, даже единственный: без имени команда останавливается
и перечисляет профили этого компьютера. Имя personal — пример: любое подойдёт.
Подробнее: вход и сессии (wirecat.dev), профили (wirecat.dev).
Настройки и права
У каждого профиля свои настройки и права; без файла настроек действуют встроенные значения.
| Настройка | Что делает | По умолчанию |
|---|---|---|
permissions |
что можно: deny, readonly, ask, allow — для команды или группы команд |
всё, кроме удаления и других необратимых действий: они спрашивают |
sends_per_hour |
сколько сообщений профиль отправит за час | 30 |
requests_per_minute |
темп обращений к MAX | 20 |
limit |
сколько строк в списке | 20 |
max personal config set permissions.messages readonly # профиль только для чтения
max personal config set permissions.messages.send ask # спрашивать перед отправкой
Подробнее: настройки (wirecat.dev), права (wirecat.dev), все ключи (wirecat.dev).
Ограничения
max держит каждый профиль в одном темпе: первые 10 запросов идут сразу, дальше — 20 в минуту, и
две команды одновременно делят этот темп. Если MAX отвечает «слишком много запросов», max
останавливается и не повторяет запрос сам. Фоновый max personal serve держит одно подключение для всех
команд и сам останавливается, когда им 15 минут никто не пользуется.
Подробнее: ограничения и ожидания (wirecat.dev).
Безопасность
- Токен входа — в системном хранилище паролей, не в истории команд. Если хранилище недоступно,
maxничего не спрашивает: кладёт токен в файл, доступный только вам, и один раз говорит об этом.session start --credential-storage fileвыбирает файл сразу — не советуем, хранилище надёжнее. - Локальная копия и служебные файлы доступны только вашему пользователю; от кражи диска защищает шифрование диска целиком.
- Перед каждой отправкой, в том числе через фоновый сервер и MCP,
maxпроверяет ограничения профиля и пишет строку в журнал — без текста сообщения. --fileне отправит известные файлы с учётными данными, папкиmaxи хранилище.- Чужой текст не управляет вашим терминалом: управляющие символы из имён и сообщений показываются как текст.
- Ограничения защищают от агента, которого уговорило прочитанное сообщение, но не от агента, который хочет их обойти: для этого нужна песочница или отдельный пользователь.
Подробнее: безопасность (wirecat.dev).
Когда не работает
max personal doctor # где лежат файлы и есть ли вход; к MAX не подключается
max personal chats list --trace # каждый запрос к MAX — без текстов, имён и токена
max personal runs list # неудачные и частичные запуски сохраняются сами
Запись --trace можно приложить к сообщению об ошибке.
Подробнее: по симптому (wirecat.dev), диагностика (wirecat.dev).
WireCat MAX MCPのよくある質問
WireCat MAX MCPをClaude Codeに追加するには
ターミナルでclaude mcp add max-cli -- npx -y @wirecat/max-cliを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
WireCat MAX MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
MAXアカウントをAIエージェントに接続するにはどうすればよいですか?
max personal setupコマンドを使用してQRコード経由でサインインできます。これにより、CLIがアカウントの追加デバイスとして認識されます。
Claude DesktopやCursorで使用できますか?
はい、max personal mcp configコマンドを実行することで、MCP対応クライアントに接続できます。
メッセージを読み取ると既読になりますか?
いいえ、デフォルトでは読み取りは安全に行われ、既読ステータスは付与されません。
ボットを使用する公式な方法はありますか?
はい、max sales botコマンドを使用することで、トークン経由で公式のMAX Bot APIを利用できます。