SAGE Wrapper — MCP-сервер для Claude Code: сжатие вывода команд
Локальный MCP-сервер, который перехватывает вывод терминала и отдаёт агенту сжатую сводку. Пригодится, когда логи тестов и сборки съедают контекст.
claude mcp add sage -- npx -y psycgod-sageЧто делает SAGE Wrapper
SAGE ставится между командой и агентом. Полный вывод остаётся на машине, до модели доходит короткая выжимка: ошибки сгруппированы, стектрейсы подрезаны, шум установки выброшен. История команд, метрики сжатия и контекст для повторов лежат в локальной базе.
MCP здесь необязателен и включается вручную. Пакет при установке ничего не активирует сам — после pip install psycgod-sage или npm install -g psycgod-sage нужно один раз выполнить sage install, а затем перезапустить открытые сессии агента, иначе новые инструкции не подхватятся. Дальше команды идут через sage run -- <command>, есть и короткие формы вроде sage pytest.
Если хост запускает шелл не в той папке, путь задаётся явно: sage run --cwd <project> -- <command> или переменной SAGE_WORKSPACE_CWD. В заблокированных приложениях, где выключены shell-инструменты, сервер бессилен — он не включает то, что запретил хост. В stdio-сессиях MCP иногда отваливается, поэтому по умолчанию надёжнее обычный sage run -- <command>.
Какие задачи решает
- ужать вывод pytest до списка упавших тестов
- не терять контекст на шумных логах сборки
- разобрать последнюю упавшую команду и получить подсказку по фиксу
- посмотреть историю недавних команд
- проверить, сколько токенов сэкономлено на сжатии
Примеры запросов агенту
- Прогони тесты через SAGE:
sage run -- python -m pytest - Запусти
sage npm testи покажи только ошибки - Объясни, почему упала последняя команда:
sage explain --failed
Как установить SAGE Wrapper
Командой платформы
claude mcp add sage -- npx -y psycgod-sageКомандой платформы
codex mcp add sage-wrapper -- npx -y psycgod-sageФайл настроек
{
"mcpServers": {
"sage-wrapper": {
"command": "npx",
"args": [
"-y",
"psycgod-sage"
]
}
}
}Файл настроек
{
"servers": {
"sage-wrapper": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"psycgod-sage"
]
}
}
}Командой платформы
gemini mcp add sage-wrapper npx -y psycgod-sageПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о SAGE Wrapper
Как установить SAGE Wrapper в Claude Code?
Сначала поставьте пакет и активируйте его: pip install psycgod-sage, затем sage install. После этого добавьте MCP-сервер командой claude mcp add sage -- npx -y psycgod-sage.
Что делает SAGE Wrapper?
Оборачивает терминальные команды, хранит сырой вывод локально и возвращает агенту сжатую сводку. Так контекст расходуется медленнее, а логи не уходят в промпт.
Нужен ли MCP для работы SAGE?
Нет. MCP включается вручную через sage mcp install, а основной путь — обычный sage run -- <command>.
