English Français العربية

io.github.TedoNeObichaJavaScript/readyorai

Official registry Developer tools

Zero-cost MCP server for local code inspection and best-practice recommendations

Source code Documentation

What can you do with io.github.TedoNeObichaJavaScript/readyorai?

  • 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 @filename and AI terminal 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package readyorai
Claude Code 
claude mcp add readyorai -- npx -y readyorai@0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "readyorai": {
            "command": "npx",
            "args": [
                "-y",
                "readyorai@0.1.2"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ReadyOrAI
  2. Features
  3. Installation
  4. CLI Usage
  5. Configuration
  6. MCP Tools
  7. MCP Prompts
  8. Checks
  9. Language Support
  10. Development
  11. Support
  12. License

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 @filename and AI terminal 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.json for shared settings
  • Inline suppressions: Silence specific findings with // readyorai-ignore comments

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
CodeMeaning
0No issues found
1Warnings found
2Errors found
3Runtime 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

ToolDescription
inspect_fileAnalyze a single file for code quality issues
inspect_directoryBatch analysis of all source files in a directory
get_metricsGet quantitative metrics (LOC, complexity, function count)
compare_filesCompare two file versions and show fixed, introduced, or unchanged findings
suggest_fixesGet actionable fix suggestions with context for each finding

MCP Prompts

PromptDescription
review-codeStructured code review with optional focus area
health-checkProject-level health assessment

Checks

CheckWhat it detects
complexityCyclomatic/cognitive complexity, deep nesting
namingConvention violations, single-letter vars, boolean prefixes
structureLong files/functions, too many parameters, long lines
patternsconsole.log, empty catch, magic numbers, nested ternaries, TODOs
importsUnused imports, wildcard imports, scattered imports
documentationMissing JSDoc/docstrings, low comment ratio
securityHardcoded secrets, eval(), SQL injection, XSS patterns
duplicationDuplicate code blocks, repeated magic strings
ai-detectionDetects patterns common in AI-generated code

Language Support

TierLanguagesAnalysis
1JavaScript, TypeScript, Python, Go, RustFull AST-powered analysis
2Java, C#, Ruby, PHP, Swift, Kotlin, C, C++Regex + heuristic analysis
3Any text fileLine-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

Frequently asked questions

What is io.github.TedoNeObichaJavaScript/readyorai?

Zero-cost MCP server for local code inspection and best-practice recommendations

How do I install io.github.TedoNeObichaJavaScript/readyorai?

It runs on your machine. In Claude Code: claude mcp add readyorai -- npx -y readyorai@0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.TedoNeObichaJavaScript/readyorai need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.TedoNeObichaJavaScript/readyorai open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.TedoNeObichaJavaScript/readyorai?

It is published by TedoNeObichaJavaScript. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.