이런 적 있으신가요? AI한테 "로그인 버그 하나만 고쳐줘"라고 했는데, 정신 차려보니 인증 시스템을 통째로 리팩토링하고 있고, 안 건드려도 될 파일까지 12개가 바뀌어 있는 상황. 바이브코딩하다 보면 한 번쯤 겪는 일이죠.
Vibe Check MCP는 이 순간에 브레이크를 거는 도구예요. AI 에이전트가 계획을 세우거나 큰 액션을 실행하기 직전에, "이거 진짜 필요한 거 맞아?"라고 되물어보는 역할을 합니다. 사람 멘토가 옆에서 "잠깐, 그거 오버 아니야?"라고 찔러주는 느낌이랄까요.
뭘 해결하나
핵심 도구는 두 개예요.
- vibe_check: 지금 세운 계획이나 사고 과정을 넘기면, 터널비전·오버엔지니어링·요청 범위 이탈 같은 패턴을 분석해서 단계에 맞는 질문을 던져줍니다.
- vibe_learn: 실수와 그 해결책을 기록해서, 같은 패턴이 반복되지 않도록 학습 데이터를 쌓아줘요.
여기에 update_constitution / check_constitution으로 세션별 규칙("이 세션에선 테스트 파일 건드리지 마" 같은)을 걸어둘 수도 있습니다.
예를 들어 "결제 모듈에 로깅만 추가해줘"라고 시켰는데 AI가 결제 로직 자체를 손보려 한다면, vibe_check가 끼어들어서 "원래 요청은 로깅 추가였는데, 지금 결제 로직 변경까지 하려는 게 맞나요?" 같은 질문을 던지는 식이에요.
어떻게 시작하나
Node 20 이상이 필요하고, Gemini·Claude·OpenAI·OpenRouter 중 하나의 API 키가 있어야 동작해요.
npx -y @pv-bhat/vibe-check-mcp start --stdio
Claude Desktop이면 설정 파일에 이렇게 추가하면 됩니다.
{
"mcpServers": {
"vibe-check-mcp": {
"command": "npx",
"args": ["-y", "@pv-bhat/vibe-check-mcp", "start", "--stdio"]
}
}
}
언제 쓰고 언제 쓰지 마라
모호한 요구사항이 있거나, 실수하면 되돌리기 힘든 고위험 작업, 여러 턴에 걸쳐 진행되는 긴 작업에 잘 맞아요. 제작자 쪽 테스트에서는 작업 성공률이 올라가고 무리한 액션은 줄었다는 결과도 나왔다고 하네요.
반대로 "버튼 색깔만 바꿔줘" 수준의 짧고 명확한 작업엔 오히려 방해가 됩니다. 매번 멈춰서 되묻는 거라 속도가 붙지 않아요. GSD Core처럼 시작 전에 스펙을 잡아주는 도구랑은 역할이 달라요. 이쪽은 "시작 전 정리"가 아니라 "진행 중 멈춰 세우기" 쪽입니다.
한계
API 키가 따로 필요해서 호출할 때마다 비용이 붙어요. 그리고 지금은 유지보수 모드라 새 기능 개발은 멈춘 상태고요(동작 자체는 정상). 무엇보다 AI가 vibe_check를 실제로 호출해야 효과가 있는 구조라, 시스템 프롬프트나 규칙에 "판단 애매하면 vibe_check부터 불러라"라고 못 박아두는 게 좋습니다.
출처: https://github.com/PV-Bhat/vibe-check-mcp-server
댓글 0
첫 댓글을 남겨보세요!