readyorai
ReadyOrAI
Бесплатный MCP-сервер для локального анализа кода. Анализирует ваш код на соответствие практикам чистого кода, лучшим практикам и даёт практические рекомендации — без изменения вашего кода и без API-запросов.
Возможности
9 анализаторов: сложность, именование, структура, паттерны, импорты, документация, безопасность, дублирование, обнаружение ИИ-сгенерированного кода
Мультиязычность: JS/TS, Python, Go, Rust (глубокий анализ) + Java, C#, Ruby, PHP и другие (на основе регулярных выражений)
Бесплатно: весь анализ выполняется локально — без API-ключей и внешних вызовов
MCP-сервер: работает с Claude Desktop, Claude Code и VS Code через stdio-транспорт
CLI-инструмент: команды
ready @filenameиAIдля автономного использованияВывод SARIF: экспорт результатов для интеграции с GitHub Code Scanning
Режим наблюдения: непрерывный повторный анализ при изменении файлов
Режим базовой линии/диффа: отслеживание поэтапного внедрения — видеть только новые проблемы
Файл конфигурации: проектный
.readyorai.jsonдля общих настроекВстроенные подавления: скрытие конкретных замечаний с помощью комментариев
// readyorai-ignore
Related MCP server: Risk Audit MCP
Установка
Как 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"]
}
}
}Как CLI-инструмент
npm install -g readyoraiИспользование 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 targetКоды выхода
Код | Значение |
| Проблем не найдено |
| Найдены предупреждения |
| Найдены ошибки |
| Ошибка выполнения |
Конфигурация
Создайте .readyorai.json в корне вашего проекта:
{
"checks": ["complexity", "naming", "security"],
"severity": "warning",
"exclude": ["dist/**", "node_modules/**"]
}Встроенные подавления
Скрыть конкретные замечания в строке:
eval(code); // readyorai-ignoreMCP-инструменты
Инструмент | Описание |
| Анализ одного файла на проблемы качества кода |
| Пакетный анализ всех исходных файлов в каталоге |
| Получение количественных метрик (LOC, сложность, количество функций) |
| Сравнение двух версий файла и показ исправленных, новых или неизменных замечаний |
| Получение практических предложений по исправлению с контекстом для каждого замечания |
MCP-промпты
Промпт | Описание |
| Структурированный обзор кода с опциональной областью фокуса |
| Оценка здоровья проекта на уровне проекта |
Проверки
Проверка | Что обнаруживает |
| Цикломатическая/когнитивная сложность, глубокая вложенность |
| Нарушения соглашений, однобуквенные переменные, булевы префиксы |
| Длинные файлы/функции, слишком много параметров, длинные строки |
| console.log, пустые catch, магические числа, вложенные тернарники, TODO |
| Неиспользуемые импорты, импорты с подстановочными знаками, разбросанные импорты |
| Отсутствие JSDoc/docstring, низкое соотношение комментариев |
| Захардкоженные секреты, eval(), SQL-инъекции, XSS-паттерны |
| Дублирующиеся блоки кода, повторяющиеся магические строки |
| Обнаружение паттернов, характерных для ИИ-сгенерированного кода |
Поддержка языков
Уровень | Языки | Анализ |
1 | JavaScript, TypeScript, Python, Go, Rust | Полный анализ на основе AST |
2 | Java, C#, Ruby, PHP, Swift, Kotlin, C, C++ | Анализ на основе регулярных выражений и эвристик |
3 | Любой текстовый файл | Построчные проверки (длина, TODO, секреты, дублирование) |
Разработка
git clone https://github.com/TedoNeObichaJavaScript/ReadyOrAI.git
cd ReadyOrAI
npm install
npm run build
npm testПоддержка
Если вы находите ReadyOrAI полезным, рассмотрите возможность поддержки проекта:
Borko — 5 евро
Лицензия
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