Vcheck (Yusef1975)

🎯 VibeCheck MCP服务器

停止编写懒惰的提示。开始发送更好的代码。

VibeCheck是一个 主控程序 （模型上下文协议）服务器，充当人工智能辅助编码的质量门。它拦截未指定的提示，并将其细化为高密度、上下文感知的指令，这样你的AI助手就可以用更少的迭代生成更好的代码。

______________________________________________________________________

为什么选择VibeCheck？

大多数AI编码提示都太模糊了。“添加登录页面”告诉你的AI关于身份验证提供商、样式、错误处理或范围的任何信息。你最终会陷入一个消耗代币和时间的修正循环。

VibeCheck 分数 你的提示， 旗帜 缺少什么， 检测 你的技术栈， 建议 相关文件，以及 变换 它被转化为具有特定角色需求的结构化指令——所有这些都在生成一行代码之前完成。

______________________________________________________________________

特性

______________________________________________________________________

快速开始

先决条件

• 18+
• MCP兼容客户端（Cursor、Claude Desktop、VS Code、Windsurf等）

安装

# Clone the repo
git clone https://github.com/yusef1975/Vcheck.git
cd Vcheck

# Install dependencies
npm install

# Build
npm run build

连接到编辑器

将VibeCheck添加到MCP客户端配置中：

Cursor

创建或编辑 .cursor/mcp.json 在您的项目中（或 ~/.cursor/mcp.json 全球）：

{
  "mcpServers": {
    "vibecheck": {
      "command": "node",
      "args": ["/absolute/path/to/Vcheck/dist/index.js"]
    }
  }
}

Claude Desktop

编辑 claude_desktop_config.json:

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "vibecheck": {
      "command": "node",
      "args": ["/absolute/path/to/Vcheck/dist/index.js"]
    }
  }
}

VS Code (Copilot)

添加 .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "vibecheck": {
        "command": "node",
        "args": ["/absolute/path/to/Vcheck/dist/index.js"]
      }
    }
  }
}

Windsurf / Antigravity

添加到MCP配置文件(mcp_config.json):

{
  "mcpServers": {
    "vibecheck": {
      "command": "node",
      "args": ["/absolute/path/to/Vcheck/dist/index.js"]
    }
  }
}

提示： 替换 /absolute/path/to/Vcheck 使用克隆仓库的实际路径。

在添加配置之后， 重新启动编辑器。工具将立即可用。

______________________________________________________________________

工具

refine_vibe_prompt

核心工具。验证、评分和转换提示。

Input:  "add a login page to my nextjs app"
Output: Structured instruction with tech-stack context, persona requirements, 
        file suggestions, security checks, and a completion checklist.

参数：

score_vibe

给出1-100分的提示，并附上详细的细分。

评分类别：

分数徽章： ❌ 懒惰（0–19）→⚠️ 弱（20–39）→⚡ 体面（40–59岁）→✅ 强壮（60-79岁）→🏆 精英（80-100）

suggest_vibe_context

扫描您的项目，并根据关键字匹配建议相关文件。

detect_tech_stack

自动检测项目的运行时、框架和依赖关系 package.json, requirements.txt，或 go.mod.

refinement_loop

对之前改进的提示进行反馈，并生成改进的V2。

init_vibecheck

生成默认值 .vibecheckrc 配置文件，创建 .vibecheck/ 目录和更新 .gitignore.

list_vibe_templates

返回启动器提示模板：

• 🚀 新功能 --结构化特征请求
• 🔧 重构 --重构指南
• 🐛 错误修复 --带有复制步骤的错误报告
• 🧪 测试套件 --测试计划模板
• 🌐 API端点 --REST端点规范

______________________________________________________________________

资源

VibeCheck公开了其他代理可以读取的两个MCP资源：

______________________________________________________________________

人物角色

每个角色都将特定领域的专家约束应用于您的提示：

______________________________________________________________________

配置

跑 init_vibecheck 生成a .vibecheckrc 在项目根目录中：

{
  "ignoredDirs": ["node_modules", ".git", "dist", "..."],
  "ignoredExtensions": [".lock", ".log", ".map", "..."],
  "maxScanFiles": 500,
  "maxScanDepth": 10,
  "customPersonas": {
    "my persona": {
      "name": "My Persona",
      "emoji": "🎨",
      "description": "A custom expert with specific constraints.",
      "expertConstraints": [
        "Always use design tokens from the shared theme.",
        "Prefer CSS Grid over Flexbox for page layouts."
      ]
    }
  }
}

______________________________________________________________________

项目结构

src/
├── index.ts        # MCP server, tool registrations, refinement engine
├── config.ts       # .vibecheckrc loading and defaults
├── personas.ts     # 5 built-in personas + custom persona support
├── scanner.ts      # Async project scanner, context suggestion, tech-stack detection
├── scoring.ts      # Vibe Score (1–100) calculation
├── security.ts     # Security guardrail patterns
├── history.ts      # History logging with 200-entry rotation
└── templates.ts    # 5 starter prompt templates

______________________________________________________________________

环境变量

______________________________________________________________________

发展

# Watch mode (auto-recompile on changes)
npm run dev

# Build
npm run build

# Run directly
npm start

______________________________________________________________________

许可证