# agent-strace

MCP-сервер agent-strace для Claude Code сохраняет действия ИИ-агентов, вызовы инструментов и ошибки на локальный диск. Помогает пошагово разбирать сессии и проверять готовность веток к ревью.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 108 у репозитория
- Автор: Siddhant-K-code
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Siddhant-K-code/agent-trace
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/agent-strace

## Что делает

Сервер сохраняет историю работы агента в локальные файлы. В лог попадают введённые промпты, запуски утилит, изменения в файловой системе и возникшие сбои. Затем эти записи можно развернуть во временной шкале или сгруппировать по этапам решения задачи, скрывая конфиденциальные строки по умолчанию.

Помимо воспроизведения событий утилита проверяет полноту собранных свидетельств со статусами от `healthy` до `invalid`. Она находит пропуски в логах провайдера, готовит отчёт о проверке ветки перед отправкой пулл-реквеста и собирает урезанный HTML-пакет для безопасного показа коллегам.

Для работы требуется Python 3.10 или новее со стандартной библиотекой, а также утилита `uvx`. Инструмент остаётся экспериментальным: опираться на него как на надёжный рубеж безопасности без собственного аудита рисков нельзя.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `AGENT_TRACE_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env AGENT_TRACE_DIR=<AGENT_TRACE_DIR> --transport stdio agent-strace -- uvx agent-strace
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>

### Codex

**Командой платформы**
```bash
codex mcp add agent-strace --env AGENT_TRACE_DIR=<AGENT_TRACE_DIR> -- uvx agent-strace
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-strace": {
            "command": "uvx",
            "args": [
                "agent-strace"
            ],
            "env": {
                "AGENT_TRACE_DIR": "<AGENT_TRACE_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-strace": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "agent-strace"
            ],
            "env": {
                "AGENT_TRACE_DIR": "<AGENT_TRACE_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e AGENT_TRACE_DIR=<AGENT_TRACE_DIR> agent-strace uvx agent-strace
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-strace <команда>

## Когда брать
- пошагово воспроизвести действия агента при отладке упавшей сессии
- проверить полноту логов и пробелы в захвате вызовов провайдера
- составить безопасный пакет доказательств для проверки пулл-реквеста
- выявить навыки и скиллы, которые агент ни разу не загрузил за время работы

## Примеры запросов агенту
- Воспроизведи по шагам последнюю сессию агента и выдели ключевые этапы
- Проверь полноту собранного трейса и покажи, какие вызовы провайдер пропустил
- Оцени готовность текущей ветки к код-ревью на основе записанного следа

## Похожие
- [orca-replay](https://affpapa.org/nevibecode/skills/orca-replay.md) — скилл · ★ 1109 у репозитория
- [strace-ltrace](https://affpapa.org/nevibecode/skills/strace-ltrace.md) — скилл · 782 установки
- [trace](https://affpapa.org/nevibecode/skills/trace.md) — скилл · 861 установка
- [grounding-before-coding](https://affpapa.org/nevibecode/skills/grounding-before-coding.md) — скилл · 25600 установок
- [principle-attack-the-premise](https://affpapa.org/nevibecode/skills/principle-attack-the-premise.md) — скилл · 10100 установок
- [debug-trace](https://affpapa.org/nevibecode/commands/debug-trace.md) — команда · ★ 42780 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
