readyorai

ReadyOrAI

ローカルでコードを検査する、無料の MCP サーバーです。コードを変更したり API を呼び出したりせずに、クリーンコードの実践、ベストプラクティスを分析し、実行可能な改善案を提示します。

Features

• 9 種類のアナライザー：複雑度、命名、構造、パターン、インポート、ドキュメント、セキュリティ、重複、AI 生成コードの検出
• マルチ言語対応：JS/TS、Python、Go、Rust（詳細な分析）＋ Java、C#、Ruby、PHP など（正規表現ベース）
• 無料：すべての分析をローカルで実行します。API キーも外部への呼び出しも不要です
• MCP サーバー：stdio トランスポート経由で Claude Desktop、Claude Code、VS Code に対応
• CLI ツール：単体で使用できる ready @filename および AI ターミナルコマンド
• SARIF 出力：GitHub Code Scanning との連携用に結果をエクスポート
• 監視モード：ファイルの変更時に継続的に再分析
• ベースライン／差分モード：段階的な導入状況を追跡し、新しい問題のみを表示
• 設定ファイル：共有設定用のプロジェクト単位の .readyorai.json
• インライン抑制：// readyorai-ignore コメントで特定の指摘を非表示にできます

Installation

MCP サーバーとして

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"]
    }
  }
}

CLI ツールとして

npm install -g readyorai

CLI の使用方法

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

終了コード

コード	意味
0	問題は見つかりませんでした
1	警告が見つかりました
2	エラーが見つかりました
3	実行時エラー

設定

プロジェクトのルートに .readyorai.json を作成します。

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

インライン抑制

行単位で特定の指摘を非表示にします。

eval(code); // readyorai-ignore

MCP ツール

ツール	説明
inspect_file	単一ファイルのコード品質に関する問題を分析します
inspect_directory	ディレクトリ内のすべてのソースファイルを一括分析します
get_metrics	定量的なメトリクス（LOC、複雑度、関数数）を取得します
compare_files	2 つのファイルのバージョンを比較し、修正済み、新たに発生、または変更なしの指摘を表示します
suggest_fixes	各指摘のコンテキストとともに、実行可能な修正案を取得します

MCP プロンプト

プロンプト	説明
review-code	任意の重点領域を指定できる、構造化されたコードレビュー
health-check	プロジェクト単位の健全性評価

チェック項目

チェック項目	検出する内容
complexity	循環的複雑度／認知的複雑度、深いネスト
naming	命名規則違反、1 文字の変数、ブール値の接頭辞
structure	長いファイル／関数、過剰なパラメーター数、長い行
patterns	console.log、空の catch、マジックナンバー、ネストした三項演算子、TODO
imports	未使用のインポート、ワイルドカードインポート、分散したインポート
documentation	JSDoc／docstring の不足、コメント比率の低さ
security	ハードコードされたシークレット、eval()、SQL インジェクション、XSS のパターン
duplication	重複したコードブロック、繰り返されるマジック文字列
ai-detection	AI 生成コードでよく見られるパターンを検出します

言語サポート

ティア	言語	分析
1	JavaScript、TypeScript、Python、Go、Rust	AST を活用した完全な分析
2	Java、C#、Ruby、PHP、Swift、Kotlin、C、C++	正規表現＋ヒューリスティック分析
3	あらゆるテキストファイル	行単位のチェック（長さ、TODO、シークレット、重複）

開発

git clone https://github.com/TedoNeObichaJavaScript/ReadyOrAI.git
cd ReadyOrAI
npm install
npm run build
npm test

サポート

ReadyOrAI が役に立った場合は、プロジェクトへの支援をご検討ください。

• Borko — 5 ユーロ

ライセンス

MIT