# CodeInspectus MCP server

> Scans AI-generated codebases locally for vulnerabilities and secrets, then guides an agent through fixing and rescanning findings.

- Repository: https://github.com/Synvoya/codeinspectus
- Page: https://hostedmcp.org/servers/synvoya/codeinspectus
- Transport: stdio
- Stars: 51
- License: Apache-2.0
- Latest version: 4.1.0

## Install

### Claude Code

```sh
claude mcp add codeinspectus -- npx -y codeinspectus
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "codeinspectus": {
      "command": "npx",
      "args": [
        "-y",
        "codeinspectus"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "codeinspectus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codeinspectus"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"codeinspectus","type":"stdio","command":"npx","args":["-y","codeinspectus"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "codeinspectus": {
      "command": "npx",
      "args": [
        "-y",
        "codeinspectus"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add codeinspectus -- npx -y codeinspectus
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.codeinspectus]
command = "npx"
args = ["-y", "codeinspectus"]
```

### Gemini CLI

```sh
gemini mcp add -s user codeinspectus npx -- -y codeinspectus
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "codeinspectus": {
      "command": "npx",
      "args": [
        "-y",
        "codeinspectus"
      ]
    }
  }
}
```

## Tools (10)

- `codeinspectus_scan`
- `codeinspectus_setup`
- `codeinspectus_rescan`
- `codeinspectus_plan_cleanup`
- `codeinspectus_apply_cleanup`
- `codeinspectus_rollback_cleanup`
- `codeinspectus_compliance_report`
- `codeinspectus_explain_finding`
- `codeinspectus_generate_sbom`
- `codeinspectus_list_rules`

## FAQ

### Does CodeInspectus require an account or send my code to the cloud?

No. It is local-first, needs no account, and performs zero network I/O during scans; engines are downloaded once after approval and called as local subprocesses.

### Which coding agents can use the CodeInspectus MCP server?

Any AI coding agent can invoke it, including Claude Code, Cursor, Codex, Windsurf, Cline, and Aider.

### Which scanning engines does CodeInspectus run?

It combines Opengrep for SAST, Gitleaks for secrets, Trivy for dependency and IaC findings, osv-scanner for offline OSV matching, plus its own Synvoya engine for AI-code-specific checks.

### What is the Node.js version requirement?

Node.js 22 or newer is required, with Node 24 LTS recommended.

### How do I install the scanning engines?

Run the interactive setup command, review the coverage, licenses, and sizes, then approve all components or select specific ones.
