# mcp-audit

MCP-сервер mcp-audit для Claude Code встаёт прокси перед любым MCP-сервером: ведёт журнал вызовов и поднимает тревогу, когда описание инструмента меняется. Всё считается локально, без аккаунта и облака.

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

## Что делает

Прокси стоит между клиентом и MCP-сервером и пишет в журнал всё, что идёт в обе стороны: имя инструмента, аргументы, ответ. Описание и схема инструмента закрепляются при первом появлении, и если сервер их потом поменяет, каждая сессия поднимает тревогу, пока человек не посмотрит разницу через `mcp-audit lock diff` и не подтвердит её через `mcp-audit lock approve`.

Поверх записи работают детекторы rug-pull, tool-poisoning и result-injection: они помечают событие и печатают предупреждение в stderr. Блокирует вызов только правило allow/deny. Сканер ищет просьбы молчать о своих действиях, пути вроде `~/.ssh` или `.env`, отправку на посторонний URL и невидимые символы.

Локальный сервер оборачивается командой `mcp-audit run -- <команда>`, удалённый идёт через `mcp-audit serve --target https://example.com/mcp --listen :9000`. Журнал лежит в `~/.mcp-audit/logs/events.jsonl`, по строке на сообщение, и наружу ничего не уходит, если не настроен вебхук. Сборка из исходников требует Go 1.24 или новее; npm-пакет и релизные бинарники стоят на 0.1.0, поэтому `mcp-audit lock` и сканирование результатов есть только в сборке.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add mcp-audit-proxy -- npx -y mcp-audit-proxy
```

### Codex

**Командой платформы**
```bash
codex mcp add mcp-audit -- npx -y mcp-audit-proxy
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-audit": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-audit-proxy"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-audit": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-audit-proxy"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add mcp-audit npx -y mcp-audit-proxy
```

## Когда брать
- поймать смену описания инструмента между сессиями
- записать, какие инструменты вызывал агент и с какими аргументами
- остановить вызов правилом allow/deny
- найти инъекцию в описании инструмента или в его ответе
- разобрать журнал вызовов через `jq`

## Примеры запросов агенту
- Покажи по журналу `~/.mcp-audit/logs/events.jsonl`, какие инструменты вызывались в последней сессии и с какими аргументами
- Проверь через `mcp-audit lock diff`, не поменялось ли описание инструмента `echo`, и покажи разницу
- Запусти `npx mcp-audit-proxy run -- npx -y @modelcontextprotocol/server-filesystem /tmp` и скажи, что попадёт в журнал

## Похожие
- [mcp-warden](https://affpapa.org/nevibecode/mcp/mcp-warden.md) — MCP-сервер · ★ 14 у репозитория
- [mcp-bastion](https://affpapa.org/nevibecode/mcp/mcp-bastion.md) — MCP-сервер · ★ 7 у репозитория
- [api-security-audit](https://affpapa.org/nevibecode/agents/api-security-audit.md) — субагент · 3202 установки
- [dependencies-audit](https://affpapa.org/nevibecode/skills/dependencies-audit.md) — скилл · 1900 установок
- [convex-security-audit](https://affpapa.org/nevibecode/skills/convex-security-audit.md) — скилл · 1600 установок
- [mcp-security-audit](https://affpapa.org/nevibecode/skills/mcp-security-audit.md) — скилл · 1100 установок

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