readyorai
ReadyOrAI
Kostenloser MCP-Server für lokale Code-Inspektion. Analysiert Ihren Code auf saubere Codepraktiken, Best Practices und gibt umsetzbare Empfehlungen – ohne Ihren Code zu ändern oder API-Aufrufe durchzuführen.
Funktionen
9 Analysatoren: Komplexität, Benennung, Struktur, Muster, Importe, Dokumentation, Sicherheit, Duplikation, Erkennung von KI-generiertem Code
Mehrsprachig: JS/TS, Python, Go, Rust (tiefgehende Analyse) + Java, C#, Ruby, PHP und mehr (regex-basiert)
Kostenlos: Die gesamte Analyse läuft lokal – keine API-Schlüssel, keine externen Aufrufe
MCP-Server: Funktioniert mit Claude Desktop, Claude Code und VS Code über stdio-Transport
CLI-Tool:
ready @filenameundAI-Terminalbefehle für den eigenständigen EinsatzSARIF-Ausgabe: Exportieren Sie Ergebnisse für die GitHub-Code-Scanning-Integration
Watch-Modus: Kontinuierliche Neuanalyse bei Dateiänderungen
Baseline-/Diff-Modus: Verfolgen Sie die schrittweise Einführung – nur neue Probleme anzeigen
Konfigurationsdatei: Projektweite
.readyorai.jsonfür gemeinsame EinstellungenInline-Unterdrückungen: Bestimmte Befunde mit
// readyorai-ignore-Kommentaren ausblenden
Related MCP server: Risk Audit MCP
Installation
Als MCP-Server
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"readyorai": {
"command": "npx",
"args": ["-y", "readyorai"]
}
}
}Claude Code:
claude mcp add readyorai -- npx -y readyoraiVS Code (.vscode/mcp.json):
{
"servers": {
"readyorai": {
"command": "npx",
"args": ["-y", "readyorai"]
}
}
}Als CLI-Tool
npm install -g readyoraiCLI-Verwendung
ready @src/index.ts # Inspect a single file
ready @src/ # Inspect a directory
ready @src/index.ts --checks security,naming # Run specific checks
ready @src/index.ts --json # JSON output
ready @src/index.ts --sarif # SARIF output (GitHub Code Scanning)
ready @src/index.ts --severity warning # Only warnings and errors
ready @src/index.ts --watch # Re-analyze on file changes
ready @src/ --baseline baseline.json # Compare against saved baseline
ready @src/ --save-baseline baseline.json # Save current results as baseline
AI # Inspect current directory
AI @src/utils.ts # Alias with file targetExit-Codes
Code | Bedeutung |
| Keine Probleme gefunden |
| Warnungen gefunden |
| Fehler gefunden |
| Laufzeitfehler |
Konfiguration
Erstellen Sie eine .readyorai.json im Projektstammverzeichnis:
{
"checks": ["complexity", "naming", "security"],
"severity": "warning",
"exclude": ["dist/**", "node_modules/**"]
}Inline-Unterdrückungen
Blenden Sie bestimmte Befunde in einer Zeile aus:
eval(code); // readyorai-ignoreMCP-Tools
Tool | Beschreibung |
| Analysiert eine einzelne Datei auf Codequalitätsprobleme |
| Stapelanalyse aller Quelldateien in einem Verzeichnis |
| Quantitative Metriken abrufen (LOC, Komplexität, Funktionsanzahl) |
| Zwei Dateiversionen vergleichen und behobene, neu eingeführte oder unveränderte Befunde anzeigen |
| Umsetzbare Korrekturvorschläge mit Kontext für jeden Befund erhalten |
MCP-Prompts
Prompt | Beschreibung |
| Strukturierte Code-Überprüfung mit optionalem Fokusbereich |
| Projektweite Gesundheitsbewertung |
Prüfungen
Check | Was er erkennt |
| Zyklomatische/kognitive Komplexität, tiefe Verschachtelung |
| Verstöße gegen Konventionen, Ein-Buchstaben-Variablen, boolesche Präfixe |
| Lange Dateien/Funktionen, zu viele Parameter, lange Zeilen |
| console.log, leere catch-Blöcke, magische Zahlen, verschachtelte Ternäroperatoren, TODOs |
| Unbenutzte Importe, Wildcard-Importe, verstreute Importe |
| Fehlende JSDoc/Docstrings, niedriges Kommentarverhältnis |
| Hartcodierte Geheimnisse, eval(), SQL-Injection, XSS-Muster |
| Doppelte Codeblöcke, wiederholte magische Zeichenfolgen |
| Erkennt Muster, die in KI-generiertem Code üblich sind |
Sprachunterstützung
Stufe | Sprachen | Analyse |
1 | JavaScript, TypeScript, Python, Go, Rust | Vollständige AST-basierte Analyse |
2 | Java, C#, Ruby, PHP, Swift, Kotlin, C, C++ | Regex + heuristische Analyse |
3 | Beliebige Textdatei | Zeilenbasierte Prüfungen (Länge, TODOs, Geheimnisse, Duplikation) |
Entwicklung
git clone https://github.com/TedoNeObichaJavaScript/ReadyOrAI.git
cd ReadyOrAI
npm install
npm run build
npm testUnterstützung
Wenn Sie ReadyOrAI nützlich finden, erwägen Sie, das Projekt zu unterstützen:
Borko — 5 euro
Lizenz
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
AI-powered codebase analysis — call graphs, security, dead code, complexity. 150+ tools.
30+ deterministic dev and delivery tools: linting, metrics, diagrams, model advice, AI-text checks.
Deep security scans of repos you own from your editor: dependency CVEs, SAST, git-history secrets.
Detects database migration table locks, terraform cost leaks, and OWASP API flaws.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables comprehensive code analysis including quality assessment, security vulnerability detection, refactoring suggestions, complexity calculations, and automatic documentation generation for multiple programming languages.50MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables security scanning of code projects to identify common vulnerabilities like XSS, injections, SSRF, and path traversal issues. Provides local, offline scanning with severity-grouped results and actionable fix suggestions for improving code security.38 npm-
- AlicenseNot gradedqualityCmaintenanceEnables AI-powered code safety analysis including risk detection, secret scanning, dependency checking, and code snapshot management. Works offline for basic features with optional cloud integration for advanced ML analysis and team collaboration.5 npm1Apache 2.0
- AlicenseAqualityAmaintenanceEnables AI assistants and developers to analyze code for language-specific best practices and idiomatic patterns across programming languages, CI automation, and configuration formats.1628 PyPI2MIT