tedoneobichajavascript avatar

Readyorai

tedoneobichajavascript/readyorai

Runs code quality checks entirely on your machine without API calls or network requests. Exposes five MCP tools: inspect_file and inspect_directory for running nine different analyzers (complexity, naming, security, duplication, AI-generated code detection, and more), get_metrics for quantitative stats, compare_files for diff analysis between versions, and suggest_fixes for actionable recommendations. Supports deep AST analysis for JavaScript, TypeScript, Python, Go, and Rust, with regex-based checks for Java, C#, Ruby, PHP, and others. Ships with two prompts for structured code reviews and project health checks. Also works as a standalone CLI tool with watch mode, SARIF output for GitHub integration, and baseline tracking to show only new issues. Reach for this when you want code review feedback without sending code to external services.

GitHub stars
1
tools
5
transport
STDIO
last updated
Apr 4, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

inspect_fileAnalyze a single file for code quality issues

Analyze a single file for code quality issues

No parameter schema in public metadata yet.

inspect_directoryBatch analysis of all source files in a directory

Batch analysis of all source files in a directory

No parameter schema in public metadata yet.

get_metricsGet quantitative metrics (LOC, complexity, function count)

Get quantitative metrics (LOC, complexity, function count)

No parameter schema in public metadata yet.

compare_filesCompare two file versions and show fixed, introduced, or unchanged findings

Compare two file versions and show fixed, introduced, or unchanged findings

No parameter schema in public metadata yet.

suggest_fixesGet actionable fix suggestions with context for each finding

Get actionable fix suggestions with context for each finding

No parameter schema in public metadata yet.

Sponsors

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 @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):


View the full README on GitHub

Details

Repository
github.com/tedoneobichajavascript/readyorai
Package
readyorai
Transport
STDIO
Registry
MCP registry, active