agent-strace — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер agent-strace для Claude Code сохраняет действия ИИ-агентов, вызовы инструментов и ошибки на локальный диск. Помогает пошагово разбирать сессии и проверять готовность веток к ревью.
MIT ★ 108 обновлён 2026-11-16
claude mcp add --env AGENT_TRACE_DIR=<AGENT_TRACE_DIR> --transport stdio agent-strace -- uvx agent-straceЧто делает agent-strace
Сервер сохраняет историю работы агента в локальные файлы. В лог попадают введённые промпты, запуски утилит, изменения в файловой системе и возникшие сбои. Затем эти записи можно развернуть во временной шкале или сгруппировать по этапам решения задачи, скрывая конфиденциальные строки по умолчанию.
Помимо воспроизведения событий утилита проверяет полноту собранных свидетельств со статусами от healthy до invalid. Она находит пропуски в логах провайдера, готовит отчёт о проверке ветки перед отправкой пулл-реквеста и собирает урезанный HTML-пакет для безопасного показа коллегам.
Для работы требуется Python 3.10 или новее со стандартной библиотекой, а также утилита uvx. Инструмент остаётся экспериментальным: опираться на него как на надёжный рубеж безопасности без собственного аудита рисков нельзя.
Какие задачи решает
- пошагово воспроизвести действия агента при отладке упавшей сессии
- проверить полноту логов и пробелы в захвате вызовов провайдера
- составить безопасный пакет доказательств для проверки пулл-реквеста
- выявить навыки и скиллы, которые агент ни разу не загрузил за время работы
Примеры запросов агенту
- Воспроизведи по шагам последнюю сессию агента и выдели ключевые этапы
- Проверь полноту собранного трейса и покажи, какие вызовы провайдер пропустил
- Оцени готовность текущей ветки к код-ревью на основе записанного следа
Как установить agent-strace
Командой платформы
claude mcp add --env AGENT_TRACE_DIR=<AGENT_TRACE_DIR> --transport stdio agent-strace -- uvx agent-straceВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>
Командой платформы
codex mcp add agent-strace --env AGENT_TRACE_DIR=<AGENT_TRACE_DIR> -- uvx agent-straceВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>
Файл настроек
{
"mcpServers": {
"agent-strace": {
"command": "uvx",
"args": [
"agent-strace"
],
"env": {
"AGENT_TRACE_DIR": "<AGENT_TRACE_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>
Файл настроек
{
"servers": {
"agent-strace": {
"type": "stdio",
"command": "uvx",
"args": [
"agent-strace"
],
"env": {
"AGENT_TRACE_DIR": "<AGENT_TRACE_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>
Командой платформы
gemini mcp add -e AGENT_TRACE_DIR=<AGENT_TRACE_DIR> agent-strace uvx agent-straceВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об agent-strace
Как установить agent-strace в Claude Code?
Выполните в терминале команду claude mcp add agent-trace -- uvx agent-strace.
Что делает agent-strace?
Фиксирует промпты, файловые операции и вызовы инструментов на локальном диске, воспроизводит ход сессии и формирует отчёты о надёжности собранного следа.
Что нужно для работы agent-strace?
Понадобятся среда Python 3.10 или новее, менеджер uv с командой uvx, а при изоляции каталогов — переменная окружения AGENT_TRACE_DIR.