Skip to content

v2.7.0

Choose a tag to compare

@PV-Bhat PV-Bhat released this 11 Oct 10:21
· 89 commits to main since this release
71e684d

Vibe Check MCP — v2.7.0

Highlights

  • First-party npx CLI with start, install, and doctor.
  • 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 .bak backup, 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/.env with 0600 perms).

CI / Release

  • Single-lockfile policy (npm).
  • Tag → build → coverage → CLI smokes → tarball verify → publish to npmjsnpx verify.

🔧 Improvements & fixes (PRs)

  • Improve SHTTP resilience & discovery (#29)
  • Honor standard PORT env (#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 npx bin + Node 20 engines (#40)
  • feat(cli): add start and doctor (#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:


📦 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 doctor

You’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 .bak is created.
    • Existing entries without our sentinel are left untouched.

Full changelog

Compare: V2.5...v2.7.0