Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
作者提供的说明(英文原文)
Zero-cost MCP server for local code inspection and best-practice recommendations
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
选择你使用的 AI 应用,然后复制设置。
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json
{
"mcpServers": {
"readyorai": {
"command": "npx",
"args": [
"-y",
"readyorai"
]
}
}
}在终端中运行这条命令
claude mcp add readyorai -- npx -y readyorai粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"readyorai": {
"command": "npx",
"args": [
"-y",
"readyorai"
]
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"readyorai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"readyorai"
]
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日
注册名称已通过 GitHub 账户 TedoNeObichaJavaScript 验证,该账户拥有此仓库
我们还没有从 GitHub 读取这个仓库
我们还没有从 GitHub 读取这个仓库
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
GitHub 仓库最后更新于–,最新版本(0.1.2)于7个月前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。
同一分类中有:Spec Driven Development, Remote Desktop Commander, Rystic
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Start, seed, clock, inspect and diff Rystic API simulators from your agent.
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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.
ready @filename and AI terminal commands for standalone use.readyorai.json for shared settings// readyorai-ignore commentsClaude 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"] } } }
npm install -g readyorai
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
| Code | Meaning |
|---|---|
0 | No issues found |
1 | Warnings found |
2 | Errors found |
3 | Runtime error |
Create a .readyorai.json in your project root:
{
"checks": ["complexity", "naming", "security"], "severity": "warning", "exclude": ["dist/", "node_modules/"] }
Silence specific findings on a line:
eval(code); // readyorai-ignore
| 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 |
| Prompt | Description |
|---|---|
review-code | Structured code review with optional focus area |
health-check | Project-level health assessment |
| 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 |
| 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) |
git clone https://github.com/TedoNeObichaJavaScript/ReadyOrAI.git
cd ReadyOrAI npm install npm run build npm test
If you find ReadyOrAI useful, consider supporting the project:
MIT