# GSC Scanner

GSC Scanner is an MCP server for AI coding assistants: it scans code, secrets, and IaC, creates exploit proofs in a sandbox, and validates fixes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18 repo stars
- Author: poliakarmai
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/poliakarmai/gsc
- Updated: 2026-10-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gsc-scanner

## What it does

GSC Scanner exposes ten MCP tools to coding assistants, such as `scan_repo`, `scan_diff`, `get_poc`, and `verify_fix`. Its rule set includes 67 detectors covering static application security testing, software composition analysis, exposed credentials, and IaC configurations.

Rather than stopping at plain rule matches, the tool generates runnable proofs-of-concept inside a sandbox. Once an agent drafts a patch, it can run `verify_fix` to confirm that the exploit no longer succeeds. The server acts strictly as a read-only inspector toward your repository files, leaving edits and pull requests to the developer.

The core engine runs inside the `ghcr.io/poliakarmai/gsc-scanner:v1` Docker container, meaning a working Docker installation and the `GSC_ALLOWED_ROOTS` variable are required. You can attach an OpenAI-compatible API key or local Ollama endpoint for secondary checks, but the scanner runs in pure regex mode if no key is provided.

## Requirements
- Needs: Docker
- Environment variables: `GSC_ALLOWED_ROOTS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```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
```
Replace <…> with your own values

### Codex

**Platform CLI**
```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
```
Replace <…> with your own values

### Cursor

**Config file**
File `.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>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.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>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform 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
```
Replace <…> with your own values

## When to use it
- scan codebases for leaked credentials and static code flaws
- generate safe proofs-of-concept to verify detected security issues
- confirm that code patches actually neutralize the exploit via `verify_fix`
- inspect uncommitted git diffs for insecure infrastructure definitions

## Example prompts
- Run `scan_repo` on this project and report any critical issues
- Check the current git diff with `scan_diff` before creating a pull request
- Generate an exploit proof with `get_poc` and confirm the patch with `verify_fix`

## Similar
- [agentic-security-scanner](https://affpapa.org/en/nevibecode/skills/agentic-security-scanner.md) — skill · 467 installs
- [aikido](https://affpapa.org/en/nevibecode/plugins/aikido.md) — plugin · ★ 17 repo stars
- [defender-for-devops](https://affpapa.org/en/nevibecode/skills/defender-for-devops.md) — skill · 166 installs
- [solana-vulnerability-scanner](https://affpapa.org/en/nevibecode/skills/solana-vulnerability-scanner.md) — skill · 6200 installs
- [secure-sdlc-agents](https://affpapa.org/en/nevibecode/plugins/secure-sdlc-agents.md) — plugin · ★ 15 repo stars
- [substrate-vulnerability-scanner](https://affpapa.org/en/nevibecode/skills/substrate-vulnerability-scanner.md) — skill · 5700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
