Readyorai

io.github.TedoNeObichaJavaScript由 GitHub 帳號 TedoNeObichaJavaScript 發布v0.1.2更新於 Oct 24, 2026

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

已驗證STDIO僅桌面開發者工具安全與監控

概覽

AI 產生的概覽

在本機執行、零成本的 MCP 伺服器，用來檢查原始碼的品質、安全與最佳實務問題並提供修正建議。

可以做什麼
  • 檢查單一檔案或整個目錄的程式碼品質問題
  • 取得程式碼行數、複雜度、函式數量等量化指標
  • 比較兩個檔案版本，查看已修正、新引入或未變動的發現
  • 針對每項發現取得附帶脈絡的可執行修正建議
  • 執行結構化的程式碼審查與專案健康檢查提示
適用情境
適合想讓助理在本機審查程式碼的整潔度、複雜度、命名、重複與安全模式，而不把程式碼送到外部服務的情況，也適合對照基準線追蹤逐步清理問題。
執行需求
以本機 stdio 程序執行，通常透過 npx 從 readyorai npm 套件啟動，因此需要 Node.js 與 npm。未宣告任何 API 金鑰或環境變數，分析完全在本機進行。
安裝前請注意
伺服器會讀取本機原始碼檔案，請只指向你願意讓助理存取的目錄。它只回報問題，不會修改程式碼。專案設定檔與行內抑制註解會影響顯示哪些發現。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Readyorai，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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 @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 fileready @src/                                  # Inspect a directoryready @src/index.ts --checks security,naming # Run specific checksready @src/index.ts --json                   # JSON outputready @src/index.ts --sarif                  # SARIF output (GitHub Code Scanning)ready @src/index.ts --severity warning       # Only warnings and errorsready @src/index.ts --watch                  # Re-analyze on file changesready @src/ --baseline baseline.json         # Compare against saved baselineready @src/ --save-baseline baseline.json    # Save current results as baselineAI                                           # Inspect current directoryAI @src/utils.ts                             # Alias with file target

Exit Codes

CodeMeaning
0No issues found
1Warnings found
2Errors found
3Runtime 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

ToolDescription
inspect_fileAnalyze a single file for code quality issues
inspect_directoryBatch analysis of all source files in a directory
get_metricsGet quantitative metrics (LOC, complexity, function count)
compare_filesCompare two file versions and show fixed, introduced, or unchanged findings
suggest_fixesGet actionable fix suggestions with context for each finding

MCP Prompts

PromptDescription
review-codeStructured code review with optional focus area
health-checkProject-level health assessment

Checks

CheckWhat it detects
complexityCyclomatic/cognitive complexity, deep nesting
namingConvention violations, single-letter vars, boolean prefixes
structureLong files/functions, too many parameters, long lines
patternsconsole.log, empty catch, magic numbers, nested ternaries, TODOs
importsUnused imports, wildcard imports, scattered imports
documentationMissing JSDoc/docstrings, low comment ratio
securityHardcoded secrets, eval(), SQL injection, XSS patterns
duplicationDuplicate code blocks, repeated magic strings
ai-detectionDetects patterns common in AI-generated code

Language Support

TierLanguagesAnalysis
1JavaScript, TypeScript, Python, Go, RustFull AST-powered analysis
2Java, C#, Ruby, PHP, Swift, Kotlin, C, C++Regex + heuristic analysis
3Any text fileLine-based checks (length, TODOs, secrets, duplication)

Development

bash
git clone https://github.com/TedoNeObichaJavaScript/ReadyOrAI.gitcd ReadyOrAInpm installnpm run buildnpm test

Support

If you find ReadyOrAI useful, consider supporting the project:

  • Borko — 5 euro

License

MIT

來源：README.md，提交 e7d0593

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分