readyorai
ReadyOrAI
Servidor MCP de costo cero para inspección de código local. Analiza tu código en busca de prácticas de código limpio, mejores prácticas y ofrece recomendaciones accionables, sin modificar tu código ni realizar llamadas a API.
Características
9 analizadores: complexity, naming, structure, patterns, imports, documentation, security, duplication, AI-generated code detection
Multilenguaje: JS/TS, Python, Go, Rust (análisis profundo) + Java, C#, Ruby, PHP y más (basado en regex)
Costo cero: Todo el análisis se ejecuta localmente: sin claves de API, sin llamadas externas
Servidor MCP: Funciona con Claude Desktop, Claude Code y VS Code mediante transporte stdio
Herramienta CLI: Comandos de terminal
ready @filenameyAIpara uso independienteSalida SARIF: Exporta resultados para integración con GitHub Code Scanning
Modo vigilancia: Reanálisis continuo ante cambios en archivos
Modo baseline/diff: Seguimiento de adopción incremental: solo muestra problemas nuevos
Archivo de configuración:
.readyorai.jsona nivel de proyecto para ajustes compartidosSupresiones en línea: Silencia hallazgos específicos con comentarios
// readyorai-ignore
Related MCP server: Risk Audit MCP
Instalación
Como servidor MCP
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"]
}
}
}Como herramienta CLI
npm install -g readyoraiUso de la CLI
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 targetCódigos de salida
Código | Significado |
| Sin problemas |
| Advertencias |
| Errores |
| Error de ejecución |
Configuración
Crea un .readyorai.json en la raíz de tu proyecto:
{
"checks": ["complexity", "naming", "security"],
"severity": "warning",
"exclude": ["dist/**", "node_modules/**"]
}Supresiones en línea
Silencia hallazgos específicos en una línea:
eval(code); // readyorai-ignoreHerramientas MCP
Herramienta | Descripción |
| Analiza un solo archivo en busca de problemas de calidad de código |
| Análisis por lotes de todos los archivos fuente en un directorio |
| Obtén métricas cuantitativas (LOC, complejidad, número de funciones) |
| Compara dos versiones de un archivo y muestra hallazgos corregidos, nuevos o sin cambios |
| Obtén sugerencias de corrección accionables con contexto para cada hallazgo |
Prompts MCP
Prompt | Descripción |
| Revisión de código estructurada con área de enfoque opcional |
| Evaluación de salud a nivel de proyecto |
Comprobaciones
Comprobación | Qué detecta |
| Complejidad ciclomática/cognitiva, anidamiento profundo |
| Violaciones de convenciones, variables de una letra, prefijos booleanos |
| Archivos/funciones largos, demasiados parámetros, líneas largas |
| console.log, catch vacío, números mágicos, ternarios anidados, TODOs |
| Importaciones no utilizadas, importaciones comodín, importaciones dispersas |
| Falta de JSDoc/docstrings, baja proporción de comentarios |
| Secretos codificados, eval(), inyección SQL, patrones XSS |
| Bloques de código duplicados, cadenas mágicas repetidas |
| Detecta patrones comunes en código generado por IA |
Soporte de lenguajes
Nivel | Lenguajes | Análisis |
1 | JavaScript, TypeScript, Python, Go, Rust | Análisis completo basado en AST |
2 | Java, C#, Ruby, PHP, Swift, Kotlin, C, C++ | Análisis con regex + heurísticas |
3 | Cualquier archivo de texto | Comprobaciones por línea (longitud, TODOs, secretos, duplicación) |
Desarrollo
git clone https://github.com/TedoNeObichaJavaScript/ReadyOrAI.git
cd ReadyOrAI
npm install
npm run build
npm testSoporte
Si encuentras útil ReadyOrAI, considera apoyar el proyecto:
Borko — 5 euros
Licencia
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