# ReadyOrAI

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-tedoneobichajavascript-readyorai`
- **Verified:** Pending review
- **Seller:** [TedoNeObichaJavaScript](https://agentstack.voostack.com/s/tedoneobichajavascript)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.2
- **License:** MIT
- **Upstream author:** [TedoNeObichaJavaScript](https://github.com/TedoNeObichaJavaScript)
- **Source:** https://github.com/TedoNeObichaJavaScript/ReadyOrAI

## Install

```sh
agentstack add mcp-tedoneobichajavascript-readyorai
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

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

**Claude Code**:

```bash
claude mcp add readyorai -- npx -y readyorai
```

**VS Code** (`.vscode/mcp.json`):

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

### As a CLI Tool

```bash
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:

```json
{
  "checks": ["complexity", "naming", "security"],
  "severity": "warning",
  "exclude": ["dist/**", "node_modules/**"]
}
```

### Inline Suppressions

Silence specific findings on a line:

```js
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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [TedoNeObichaJavaScript](https://github.com/TedoNeObichaJavaScript)
- **Source:** [TedoNeObichaJavaScript/ReadyOrAI](https://github.com/TedoNeObichaJavaScript/ReadyOrAI)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.2 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** yes

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.2** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-tedoneobichajavascript-readyorai
- Seller: https://agentstack.voostack.com/s/tedoneobichajavascript
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.