Server data from the Official MCP Registry
Zero-cost MCP server for local code inspection and best-practice recommendations
About
Zero-cost MCP server for local code inspection and best-practice recommendations
Security Report
Valid MCP server (2 strong, 2 medium validity signals). 4 known CVEs in dependencies (0 critical, 4 high severity) Package registry verified. Imported from the Official MCP Registry.
8 files analyzed · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-tedoneobichajavascript-readyorai": {
"args": [
"-y",
"readyorai"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.