ローカルコード検査のためのゼロコストMCPサーバー。クリーンコードの実践、ベストプラクティスについてコードを分析し、実行可能な推奨事項を提供します。コードを変更したり、API呼び出しを行ったりすることはありません。
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コメントで特定の検出結果を非表示
Related MCP server: Risk Audit MCP
Claude Desktop（claude_desktop_config.json）:
{
"mcpServers": {
"readyorai": {
"command": "npx",
"args": ["-y", "readyorai"]
}
}
}Claude Code:
claude mcp add readyorai -- npx -y readyoraiVS Code（.vscode/mcp.json）:
{
"servers": {
"readyorai": {
"command": "npx",
"args": ["-y", "readyorai"]
}
}
}npm install -g readyoraiready @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コード | 意味 |
| 問題なし |
| 警告あり |
| エラーあり |
| 実行時エラー |
プロジェクトのルートに.readyorai.jsonを作成します:
{
"checks": ["complexity", "naming", "security"],
"severity": "warning",
"exclude": ["dist/**", "node_modules/**"]
}特定の行の検出結果を非表示にする:
eval(code); // readyorai-ignoreツール | 説明 |
| コード品質の問題について単一ファイルを分析 |
| ディレクトリ内のすべてのソースファイルの一括分析 |
| 定量的メトリクス（LOC、複雑度、関数数）を取得 |
| 2つのファイルバージョンを比較し、修正済み、新規導入、または変更なしの検出結果を表示 |
| 各検出結果に対するコンテキスト付きの実行可能な修正提案を取得 |
プロンプト | 説明 |
| オプションの焦点領域付きの構造化コードレビュー |
| プロジェクトレベルの健全性評価 |
チェック | 検出内容 |
| 循環的/認知的複雑度、深いネスト |
| 命名規則違反、一文字変数、ブール接頭辞 |
| 長いファイル/関数、パラメータ数过多、長い行 |
| console.log、空のcatch、マジックナンバー、ネストされた三項演算子、TODO |
| 未使用インポート、ワイルドカードインポート、散在するインポート |
| JSDoc/docstringの欠落、低いコメント比率 |
| ハードコードされたシークレット、eval()、SQLインジェクション、XSSパターン |
| 重複コードブロック、繰り返されるマジック文字列 |
| 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 testReadyOrAIが役立つと感じたら、プロジェクトへのサポートを検討してください:
Borko — 5ユーロ
MIT
This server cannot be deployed
AI-powered codebase analysis — call graphs, security, dead code, complexity. 150+ tools.
30+ deterministic dev and delivery tools: linting, metrics, diagrams, model advice, AI-text checks.
Deep security scans of repos you own from your editor: dependency CVEs, SAST, git-history secrets.
Detects database migration table locks, terraform cost leaks, and OWASP API flaws.
