# GSC Scanner

GSC Scanner — MCP-сервер для ИИ-агентов: сканирует код, секреты и IaC, создаёт PoC в песочнице и проверяет исправления.

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

## Что делает

GSC Scanner открывает для ИИ-ассистентов десять инструментов через протокол MCP, включая `scan_repo`, `scan_diff`, `get_poc` и `verify_fix`. Движок содержит 67 детекторов для анализа исходников (SAST), зависимостей (SCA), забытых секретов и конфигураций инфраструктуры как кода.

Вместо обычной выдачи строк с совпадениями сканер умеет формировать воспроизводимый PoC и запускать его в изолированном окружении. После внесения правок агент вызывает `verify_fix` и проверяет, перестал ли срабатывать проверочный эксплойт. Репозиторий при этом защищён: сервер работает только на чтение и сам файлы не перезаписывает.

Движок поставляется в виде закрытого Docker-образа `ghcr.io/poliakarmai/gsc-scanner:v1`, поэтому без установленного демона Docker запустить его не выйдет. Для работы обязательно задать переменную окружения `GSC_ALLOWED_ROOTS`. Для дополнительной проверки результатов можно подключить ключ к любой OpenAI-совместимой модели или Ollama, а без ключа инструмент работает в режиме анализа по регулярным выражениям.

## Требования
- Нужно: Docker
- Переменные окружения: `GSC_ALLOWED_ROOTS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env GSC_ALLOWED_ROOTS=<GSC_ALLOWED_ROOTS> --transport stdio gsc-scanner -- docker run -i --rm -e GSC_ALLOWED_ROOTS ghcr.io/poliakarmai/gsc-scanner:v1
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add gsc-scanner --env GSC_ALLOWED_ROOTS=<GSC_ALLOWED_ROOTS> -- docker run -i --rm -e GSC_ALLOWED_ROOTS ghcr.io/poliakarmai/gsc-scanner:v1
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gsc-scanner": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "GSC_ALLOWED_ROOTS",
                "ghcr.io/poliakarmai/gsc-scanner:v1"
            ],
            "env": {
                "GSC_ALLOWED_ROOTS": "<GSC_ALLOWED_ROOTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "gsc-scanner": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "GSC_ALLOWED_ROOTS",
                "ghcr.io/poliakarmai/gsc-scanner:v1"
            ],
            "env": {
                "GSC_ALLOWED_ROOTS": "<GSC_ALLOWED_ROOTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e GSC_ALLOWED_ROOTS=<GSC_ALLOWED_ROOTS> gsc-scanner docker run -i --rm -e GSC_ALLOWED_ROOTS ghcr.io/poliakarmai/gsc-scanner:v1
```
Вместо <…> подставьте свои значения

## Когда брать
- найти открытые секреты и уязвимости в кодовой базе проекта
- создать безопасный PoC для подтверждения найденной проблемы
- проверить через `verify_fix`, устраняет ли предложенный патч найденный баг
- просканировать изменения в git diff перед отправкой коммита

## Примеры запросов агенту
- Проверь весь текущий репозиторий через `scan_repo` и выведи критические уязвимости
- Запусти `scan_diff` для подготовленных изменений и проверь настройки IaC
- Используй `verify_fix`, чтобы подтвердить исправление для найденной проблемы

## Похожие
- [agentic-security-scanner](https://affpapa.org/nevibecode/skills/agentic-security-scanner.md) — скилл · 467 установок
- [aikido](https://affpapa.org/nevibecode/plugins/aikido.md) — плагин · ★ 17 у репозитория
- [defender-for-devops](https://affpapa.org/nevibecode/skills/defender-for-devops.md) — скилл · 166 установок
- [solana-vulnerability-scanner](https://affpapa.org/nevibecode/skills/solana-vulnerability-scanner.md) — скилл · 6200 установок
- [secure-sdlc-agents](https://affpapa.org/nevibecode/plugins/secure-sdlc-agents.md) — плагин · ★ 15 у репозитория
- [substrate-vulnerability-scanner](https://affpapa.org/nevibecode/skills/substrate-vulnerability-scanner.md) — скилл · 5700 установок

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