Skip to main content
Glama

CodeSafer (cleaner-code)

KI-Code-Sicherheitsscanner als Model Context Protocol (MCP) Server. Erkennt versteckte Bedrohungen in KI-generiertem Code, die herkömmliche Linter übersehen.

npm license: ISC Node

Website: codesafer.org  ·  MCP-Clients: Claude Code, Cursor, VS Code + Copilot, Cline


Warum CodeSafer?

KI-Coding-Assistenten generieren Code schnell – aber wer überprüft ihn auf versteckte Bedrohungen?

Aktuelle Angriffe auf die Lieferkette zeigen, dass bösartiger Code sich auf Arten verstecken kann, die menschliche Prüfer und herkömmliche Linter routinemäßig übersehen:

  • Unsichtbare Unicode-Zeichen, die in Bezeichner eingefügt werden (über 30 Varianten)

  • BiDi / Trojan Source-Angriffe, die die Anzeige von Code gegenüber seiner Ausführung verfälschen (CVE-2021-42574)

  • Homoglyphen – kyrillische Zeichen, die sich als lateinische tarnen (CVE-2021-42694)

  • Unicode-Steganographie im Glassworm-Stil, die Payloads in Leerzeichen versteckt

  • Backdoors in Regeldateien, die in .cursorrules, CLAUDE.md und anderen KI-Konfigurationsdateien platziert werden

  • Typosquatting-Abhängigkeiten in package.json

  • Obfuskationsmuster – eval + base64, Reverse Shells, gepackte Payloads

CodeSafer scannt auf all dies, bevor der Code auf Ihrem Rechner ausgeführt wird.


Related MCP server: guardvibe

Funktionsweise

CodeSafer läuft als lokaler MCP-Server. Ihr KI-Client (Claude Code, Cursor, etc.) ruft dessen Tools beim Überprüfen oder Generieren von Code auf, und die Ergebnisse werden inline zurückgegeben.

Hybride Erkennung:

  1. 8 statische Analysescan-Module – deterministische Regeln für bekannte Angriffskategorien (schnell, null falsch-negative Ergebnisse bei den abgedeckten Mustern).

  2. CodeBERT-Deep-Analyse – ein Transformer-Modell klassifiziert Code-Abschnitte mit Konfidenzwerten als bösartig/gutartig. Erkennt obfuskierte oder neuartige Muster, die statische Regeln übersehen.

Nichts verlässt Ihren Rechner. Die KI-Analyse läuft lokal gegen einen Tokenizer-Server.


Funktionen

Fähigkeit

Details

Erkennung unsichtbarer Zeichen

Über 30 Unicode-Varianten, einschließlich Zero-Width Space, Mongolian Vowel Separator

BiDi / Trojan Source

Vollständige Abdeckung von CVE-2021-42574

Homoglyphen-Erkennung

Kyrillische/Griechische/Lateinische Verwechslungszeichen (CVE-2021-42694)

Unicode-Steganographie

Leerzeichen-Payloads im Glassworm-Stil

Backdoors in Regeldateien

Scannt .cursorrules, CLAUDE.md, .claude/, Cursor-Regeln

Abhängigkeitsscan

Typosquatting + verdächtige Installationsskripte in package.json

Obfuskationserkennung

eval + base64, Reverse Shells, gepackte Payloads

KI-Deep-Analyse

CodeBERT-Transformer-Klassifikator mit Konfidenzwerten

MCP-nativ

6 MCP-Tools, stdio-Transport

Local-first

Kein Code-Upload – läuft vollständig auf Ihrem Rechner


MCP-Tools

CodeSafer stellt Ihrem MCP-Client sechs Tools zur Verfügung:

Tool

Zweck

scan_file

Scannt eine einzelne Datei auf versteckte bösartige Codemuster

scan_directory

Scannt ein Verzeichnis rekursiv über alle Quelldateien hinweg

scan_rules_file

Scannt eine KI-Konfigurations-/Regeldatei auf Prompt-Injection und Backdoor-Angriffe in Regeldateien

check_dependencies

Überprüft package.json auf Typosquatting, verdächtige Installationsskripte und Abhängigkeitsrisiken

ai_analyze

Tiefe KI-Analyse unter Verwendung des trainierten CodeBERT-Modells (klassifiziert Abschnitte als bösartig/gutartig mit Konfidenz)

explain_finding

Detaillierte Erklärung einer spezifischen Bedrohungskategorie mit Angriffsszenarien und Behebung


Installation

Voraussetzungen

  • Node.js 18 oder neuer

  • Ein MCP-kompatibler Client (Claude Code, Cursor, VS Code + Copilot, Cline)

Aus dem Quellcode

git clone https://github.com/goldmembrane/cleaner-code.git
cd cleaner-code
npm install
npm run build

Konfigurieren Sie Ihren MCP-Client

Claude Code (~/.claude.json oder Projekt .mcp.json):

{
  "mcpServers": {
    "codesafer": {
      "command": "node",
      "args": ["/absolute/path/to/cleaner-code/dist/index.js"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "codesafer": {
      "command": "node",
      "args": ["/absolute/path/to/cleaner-code/dist/index.js"]
    }
  }
}

Starten Sie Ihren Client neu, und die CodeSafer-Tools erscheinen in der Tool-Auswahl.


Verwendung

Sobald die Konfiguration abgeschlossen ist, können Sie Ihren KI-Client Dinge fragen wie:

  • "Scan this file for hidden security issues."

  • "Check the dependencies in package.json for typosquatting."

  • "Scan .cursorrules for a rules-file backdoor."

  • "Run a deep AI analysis of src/auth.ts."

  • "Explain what a Trojan Source attack is and how to fix the finding above."

Der Client ruft das entsprechende MCP-Tool auf und gibt die Ergebnisse mit Schweregrad, Zeilennummern und Hinweisen zur Behebung zurück.


Kostenlose Stufe & Pläne

CodeSafer ist kostenlos nutzbar. Die statische Analyse (scan_file, scan_directory, scan_rules_file, check_dependencies, explain_finding) ist unbegrenzt.

Die KI-Deep-Analyse (ai_analyze) beinhaltet 10 kostenlose Durchläufe pro Sitzung. Kostenpflichtige Pläne für höhere KI-Kontingente sind unter codesafer.org verfügbar.


Erkennungskategorien

CodeSafer erkennt Bedrohungen in 9 Kategorien:

  1. Unsichtbare Unicode-Zeichen – über 30 Varianten, einschließlich Zero-Width Space, Zero-Width Joiner

  2. BiDi / Trojan Source-Angriffe – CVE-2021-42574

  3. Homoglyphen – Kyrillische/Griechische Zeichen, die sich als lateinische tarnen (CVE-2021-42694)

  4. Unicode-Steganographie – Glassworm-Muster in Leerzeichen

  5. Backdoors in Regeldateien – bösartige Anweisungen in .cursorrules, CLAUDE.md, etc.

  6. Abhängigkeitsrisiken – Typosquatting und verdächtige Installationsskripte

  7. Obfuskationsmuster – eval + base64, gepackte Payloads, Reverse Shells

  8. Statische Analyseergebnisse – 8 deterministische Scanner

  9. KI-Deep-Analyse – CodeBERT-Transformer für neuartige und obfuskierte Bedrohungen


Projektstruktur

cleaner-code/
├── src/
│   ├── index.ts           # MCP server entry point
│   ├── api-server.ts      # Optional HTTP API server
│   ├── types.ts           # Scanner interfaces
│   ├── utils.ts           # File collection, summary formatting
│   └── scanner/
│       ├── invisible.ts       # Invisible Unicode scanner
│       ├── bidi.ts            # BiDi / Trojan Source scanner
│       ├── homoglyph.ts       # Homoglyph scanner
│       ├── encoding.ts        # Encoding / charset scanner
│       ├── obfuscation.ts     # Obfuscation pattern scanner
│       ├── steganography.ts   # Unicode steganography scanner
│       ├── rules-backdoor.ts  # Rules file backdoor scanner
│       ├── dependency.ts      # Dependency risk scanner
│       └── ai-analyzer.ts     # CodeBERT deep analyzer
├── ml/                    # ML model assets and tokenizer
├── functions/             # Cloud function deployments
├── deploy/                # Deployment manifests
└── web/                   # Landing page assets

Lizenz

ISC – siehe die LICENSE-Datei für Details.


Available Tools

6 tools
ai_analyzeA

Deep AI analysis of code using the trained CodeBERT model. Classifies code chunks as malicious or benign with confidence scores. Detects obfuscated payloads, novel attack patterns, and threats that static rules may miss.

Inputs: file_path (required).

check_dependenciesB

Check package.json for typosquatting, suspicious install scripts, and dependency risks

Inputs: file_path (required).

explain_findingA

Get detailed explanation of a specific threat category including attack scenarios, real-world examples, and remediation steps

Inputs: category (required).

scan_directoryB

Recursively scan a directory for hidden malicious code patterns across all source files

Inputs: dir_path (required), extensions.

scan_fileB

Scan a single file for hidden malicious code patterns (invisible chars, BiDi, homoglyphs, steganography, obfuscation, etc.)

Inputs: file_path (required).

scan_rules_fileA

Scan an AI configuration/rules file for prompt injection and Rules File Backdoor attacks

Inputs: file_path (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: scan_file vs scan_directory differ by scope, ai_analyze uses ML, check_dependencies focuses on dependencies, and scan_rules_file is for configuration files. No ambiguity.

    Naming Consistency4/5

    Tools mostly follow verb_noun snake_case pattern (e.g., scan_file, check_dependencies). The outlier is ai_analyze, which uses a prefix instead of a verb-noun structure, but it's still clear and consistent overall.

    Tool Count5/5

    With 6 tools covering scanning, AI analysis, dependency checks, and explanations, the count is well-scoped for a focused security analysis server. Not too many or too few.

    Completeness4/5

    The tools cover core scanning and analysis tasks well, including file/directory scanning, dependency risks, AI-based analysis, and explanations. A minor gap is the lack of a tool for aggregated reporting or finding management, but the surface is largely complete for detection and explanation.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Security MCP server with 300+ rules for AI-generated code. Scans Next.js, Supabase, Clerk, Stripe, Prisma, Hono, GraphQL and 20+ modules. Zero config, runs locally.
      39
      2,686 npm
      6
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      MCP security server for AI coding agents. 12 tools: pre-install guardian, vulnerability audit, supply-chain attack detection via static code analysis, and CycloneDX 1.6 SBOM generation. Zero runtime dependencies.
      15
      81 npm
      15
      Apache 2.0