v2.7.0
Vibe Check MCP — v2.7.0
Highlights
- First-party
npxCLI withstart,install, anddoctor. - One-liner installers for Claude Desktop, Cursor, Windsurf, and VS Code — safe, idempotent, with backups.
- CI + Releases now publish to npmjs on tags and smoke-test the CLI automatically.
- Transport support tightened: STDIO (default) across clients, HTTP where supported.
Shout-out: the CLI push was inspired by sangjin-kim-eyk thanks for the issue and PR.
✨ What’s new
CLI (first-party)
npx @pv-bhat/vibe-check-mcp start [--stdio | --http --port 2091]npx @pv-bhat/vibe-check-mcp install --client <claude|cursor|windsurf|vscode> [--dry-run]npx @pv-bhat/vibe-check-mcp doctor
Thin wrapper: flags → env → spawn compiled server. No global install, no repo clone.
Installers (idempotent + safe)
-
Claude Desktop: merges a managed entry with
.bakbackup, atomic writes, and a sentinel to avoid clobbering user config. -
Cursor / Windsurf / VS Code:
- Locates client configs (or prints a paste-ready snippet).
- Supports STDIO everywhere; HTTP where client docs allow.
- Always keeps secrets out of client files (use
~/.vibe-check/.envwith0600perms).
CI / Release
- Single-lockfile policy (npm).
- Tag → build → coverage → CLI smokes → tarball verify → publish to npmjs →
npxverify.
🔧 Improvements & fixes (PRs)
- Improve SHTTP resilience & discovery (#29)
- Honor standard
PORTenv (#30) - MCP Trust Score (#27)
- Add STDIO transport for Windsurf (fixes Windows startup) (#31)
- Update axios (npm audit) (#33)
- CPI integration docs (#34)
- Document STDIO requirement for Claude Desktop (#39)
- feat(cli): add
npxbin + Node 20 engines (#40) - feat(cli): add
startanddoctor(#42) - feat(cli):
install --client claude(idempotent merge) (#44) - chore(ci+release): npmjs publish, CLI smokes, standardize on npm lockfile (#45)
- feat(cli+docs): installers for Cursor, Windsurf, VS Code; docs consolidation (v2.7) (#46)
New contributors:
- @Matvey-Kuk (#27)
- @narraje (#31)
📦 Quickstart
# Try it now (Claude-friendly)
npx @pv-bhat/vibe-check-mcp start --stdio
# Install into a client
npx @pv-bhat/vibe-check-mcp install --client claude
npx @pv-bhat/vibe-check-mcp install --client cursor
npx @pv-bhat/vibe-check-mcp install --client windsurf
npx @pv-bhat/vibe-check-mcp install --client vscode --config ./.vscode/mcp.json
# Diagnose
npx @pv-bhat/vibe-check-mcp doctorYou’ll need one model provider key (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY). The CLI stores secrets in ~/.vibe-check/.env (0600).
⚠️ Notes & compatibility
-
Node.js ≥ 20 required (enforced).
-
Project standardized on npm lockfile (removed pnpm lock).
-
Client installers are idempotent and non-destructive:
- Writes are atomic; a timestamped
.bakis created. - Existing entries without our sentinel are left untouched.
- Writes are atomic; a timestamped
Full changelog
Compare: V2.5...v2.7.0