About io.github.TedoNeObichaJavaScript/readyorai
io.github.TedoNeObichaJavaScript/readyorai is an MCP server in the Developer Tools category: zero-cost MCP server for local code inspection and best-practice recommendations. It has been installed 0 times through Conduid.
Install
Claude Code
claude mcp add io-github-tedoneobichajavascript-readyorai -- npx -y readyorainpx
npx -y readyoraiThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about io.github.TedoNeObichaJavaScript/readyorai
Powered by Claude · Grounded in docs
I know everything about io.github.TedoNeObichaJavaScript/readyorai. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- ·Scoped permissionsNot checked yet.
README
ReadyOrAI
Zero-cost MCP server for local code inspection. Analyzes your code for clean code practices, best practices, and gives actionable recommendations — without modifying your code or making API calls.
Features
- 9 analyzers: complexity, naming, structure, patterns, imports, documentation, security, duplication, AI-generated code detection
- Multi-language: JS/TS, Python, Go, Rust (deep analysis) + Java, C#, Ruby, PHP, and more (regex-based)
- Zero-cost: All analysis runs locally — no API keys, no external calls
- MCP server: Works with Claude Desktop, Claude Code, and VS Code via stdio transport
- CLI tool:
ready @filenameandAIterminal commands for standalone use - SARIF output: Export results for GitHub Code Scanning integration
- Watch mode: Continuous re-analysis on file changes
- Baseline/diff mode: Track incremental adoption — only see new issues
- Config file: Project-level
.readyorai.jsonfor shared settings - Inline suppressions: Silence specific findings with
// readyorai-ignorecomments
Installation
As an MCP Server
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"readyorai": {
"command": "npx",
"args": ["-y", "readyorai"]
}
}
}
Claude Code:
claude mcp add readyorai -- npx -y readyorai
VS Code (.vscode/mcp.json):
{
"servers": {
"readyorai": {
"command": "npx",
"args": ["-y", "readyorai"]
}
}
}
As a CLI Tool
npm install -g readyorai
CLI Usage
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
Exit Codes
| Code | Meaning |
|---|---|
0 |
No issues found |
1 |
Warnings found |
2 |
Errors found |
3 |
Runtime error |
Configuration
Create a .readyorai.json in your project root:
{
"checks": ["complexity", "naming", "security"],
"severity": "warning",
"exclude": ["dist/**", "node_modules/**"]
}
Inline Suppressions
Silence specific findings on a line:
eval(code); // readyorai-ignore
MCP Tools
| Tool | Description |
|---|---|
inspect_file |
Analyze a single file for code quality issues |
inspect_directory |
Batch analysis of all source files in a directory |
get_metrics |
Get quantitative metrics (LOC, complexity, function count) |
compare_files |
Compare two file versions and show fixed, introduced, or unchanged findings |
suggest_fixes |
Get actionable fix suggestions with context for each finding |
MCP Prompts
| Prompt | Description |
|---|---|
review-code |
Structured code review with optional focus area |
health-check |
Project-level health assessment |
Checks
| Check | What it detects |
|---|---|
complexity |
Cyclomatic/cognitive complexity, deep nesting |
naming |
Convention violations, single-letter vars, boolean prefixes |
structure |
Long files/functions, too many parameters, long lines |
patterns |
console.log, empty catch, magic numbers, nested ternaries, TODOs |
imports |
Unused imports, wildcard imports, scattered imports |
documentation |
Missing JSDoc/docstrings, low comment ratio |
security |
Hardcoded secrets, eval(), SQL injection, XSS patterns |
duplication |
Duplicate code blocks, repeated magic strings |
ai-detection |
Detects patterns common in AI-generated code |
Language Support
| Tier | Languages | Analysis |
|---|---|---|
| 1 | JavaScript, TypeScript, Python, Go, Rust | Full AST-powered analysis |
| 2 | Java, C#, Ruby, PHP, Swift, Kotlin, C, C++ | Regex + heuristic analysis |
| 3 | Any text file | Line-based checks (length, TODOs, secrets, duplication) |
Development
git clone https://github.com/TedoNeObichaJavaScript/ReadyOrAI.git
cd ReadyOrAI
npm install
npm run build
npm test
Support
If you find ReadyOrAI useful, consider supporting the project:
- Borko — 5 euro
License
MIT
README mirrored from the source repository 5 months ago. The original is authoritative.