Readyorai

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "readyorai": {
      "command": "npx",
      "args": [
        "-y",
        "readyorai"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (5)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Readyorai.

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

Documentation Overview

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

config.json

{
  "mcpServers": {
    "readyorai": {
      "command": "npx",
      "args": ["-y", "readyorai"]
    }
  }
}

Claude Code:

Terminal

claude mcp add readyorai -- npx -y readyorai

VS Code (.vscode/mcp.json):

config.json

{
  "servers": {
    "readyorai": {
      "command": "npx",
      "args": ["-y", "readyorai"]
    }
  }
}

As a CLI Tool

Terminal

npm install -g readyorai

CLI Usage

bash

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:

config.json

{
  "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

bash

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

5mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Readyorai

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "readyorai": { "command": "npx", "args": ["-y","readyorai"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/readyorai?style=directory)](https://allmcps.com/mcp/readyorai)

HTML Embed

<a href="https://allmcps.com/mcp/readyorai"><img src="https://allmcps.com/api/badge/readyorai?style=directory" alt="Readyorai on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

2/6 checks healthy over the last 45d

47Quality signal: Fair · 47/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools24/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · readyorai (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Readyorai →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Readyorai

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "readyorai": {
      "command": "npx",
      "args": [
        "-y",
        "readyorai"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (5)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Readyorai.

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

Documentation Overview

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

config.json

{
  "mcpServers": {
    "readyorai": {
      "command": "npx",
      "args": ["-y", "readyorai"]
    }
  }
}

Claude Code:

Terminal

claude mcp add readyorai -- npx -y readyorai

VS Code (.vscode/mcp.json):

config.json

{
  "servers": {
    "readyorai": {
      "command": "npx",
      "args": ["-y", "readyorai"]
    }
  }
}

As a CLI Tool

Terminal

npm install -g readyorai

CLI Usage

bash

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:

config.json

{
  "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

bash

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

5mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Readyorai

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "readyorai": { "command": "npx", "args": ["-y","readyorai"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/readyorai?style=directory)](https://allmcps.com/mcp/readyorai)

HTML Embed

<a href="https://allmcps.com/mcp/readyorai"><img src="https://allmcps.com/api/badge/readyorai?style=directory" alt="Readyorai on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

2/6 checks healthy over the last 45d

47Quality signal: Fair · 47/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools24/30

Adoption & activity1/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · readyorai (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Readyorai →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients