Vibe Check MCP

by PV-Bhat
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables environment variable configuration through a .env file to store API keys and other configuration values.

  • Hosted on GitHub with repository access for cloning, contributing, and accessing documentation and case studies.

  • Supports installation and management of dependencies through npm, with commands for building and running the server.

🧠 바이브 체크 MCP

또한 mcpservers.org , Glama.ai , mcp.so 에서 Vibecheck를 찾아보세요.

AI가 스스로 고무 오리를 만들 수 없을 때, 그 AI의 내부에 있는 고무 오리가 작동합니다.

바이브 체크란 무엇인가요?

"바이브 코딩" 시대에 AI 에이전트는 이제 놀라운 능력을 갖추게 되었지만, 이제 질문은 다음과 같이 바뀌었습니다.

~에서

"우리 AI 에이전트가 정말 이렇게 복잡한 작업을 수행할 수 있을까?"

에게

"제가 수십억 달러 규모의 기술 회사를 위한 인프라가 아닌 간단한 프로그램을 작성하고 싶어한다는 것을 AI 에이전트가 이해할 수 있을까요?"

AI 에이전트가 현재 제공하지 않는 필수적인 "잠깐만... 이게 아니야" 순간을 제공합니다. 바로 자체 수정 감독 계층입니다. Vibe Coder의 완벽한 정신 건강 점검 MCP 서버입니다.

  • 전략적 패턴 인터럽트를 구현하여 AI 워크플로에서 연쇄 오류가 발생하는 것을 방지합니다.
  • LearnLM 1.5 Pro(Gemini API)와 함께 "Vibe Check"라는 도구를 사용하여 교육학 및 메타인지에 맞게 미세 조정하여 복잡한 워크플로 전략을 강화하고 터널 비전 오류를 방지합니다.
  • "Vibe Distill"을 구현하여 계획 단순화를 장려하고, 과도한 솔루션 엔지니어링을 방지하고, 상담원의 상황적 편차를 최소화합니다.
  • 자체 개선 피드백 루프: 에이전트는 "Vibe Learn"에 실수를 기록하여 의미적 회수를 개선하고 감독 AI가 시간 경과에 따라 패턴을 타겟팅하도록 도울 수 있습니다.

요약: 에이전트를 중지하고 잘못된 작업을 수행하기 전에 다시 고려하도록 미세 조정된 에이전트를 구현합니다.

문제: 패턴 관성

바이브 코딩 운동에서 우리는 모두 LLM을 사용하여 코드를 생성하고, 리팩토링하고, 디버깅합니다. 하지만 이러한 모델에는 치명적인 결함이 있습니다. 일단 추론 경로로 접어들면, 그 경로가 명백히 잘못되었음에도 불구하고 계속 추론 경로를 따라간다는 것입니다.

지엑스피1

패턴 관성은 다음과 같은 결과를 초래합니다.

  • 🔄 터널 비전 : 에이전트가 한 가지 접근 방식에 갇혀 대안을 찾지 못하는 경우
  • 📈 범위 확장 : 간단한 작업이 점차 기업 규모 솔루션으로 발전합니다.
  • 🔌 과도한 엔지니어링 : 필요하지 않은 문제에 추상화 계층을 추가하는 것
  • 정렬 불량 : 요청한 문제와 인접해 있지만 다른 문제를 해결함

특징: 메타인지 감독 도구

Vibe Check는 세 가지 통합 도구를 통해 에이전트 워크플로에 메타인지 계층을 추가합니다.

🛑 바이브 체크

터널 비전을 깨는 메타인지적 질문으로 패턴 인터럽트 메커니즘을 구현합니다.

vibe_check({ "phase": "planning", // planning, implementation, or review "userRequest": "...", // FULL original user request "plan": "...", // Current plan or thinking "confidence": 0.7 // Optional: 0-1 confidence level })

⚓ vibe_distill

복잡한 워크플로를 재조정하는 메타 사고 앵커 포인트 :

vibe_distill({ "plan": "...", // Detailed plan to simplify "userRequest": "..." // FULL original user request })

🔄 바이브런

시간이 지남에 따라 패턴 인식을 구축하는 자체 개선 피드백 루프 :

vibe_learn({ "mistake": "...", // One-sentence description of mistake "category": "...", // From standard categories "solution": "..." // How it was corrected })

Vibe Check 실행

진동 체크 전:

Claude는 모호함에도 불구하고 MCP의 의미를 가정하여 이후의 모든 단계에서 이 잘못된 가정을 하게 됩니다.

진동 확인 후:

Vibe Check MCP가 호출되어 모호성을 지적하고 Claude가 정보 부족을 인정하고 이를 적극적으로 해결하도록 강요합니다.

설치 및 설정

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 vibe-check-mcp-server를 자동으로 설치하려면:

npx -y @smithery/cli install @PV-Bhat/vibe-check-mcp-server --client claude

npm을 통한 수동 설치(권장)

# Clone the repo git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git cd vibe-check-mcp-server # Install dependencies npm install # Build the project npm run build # Start the server npm run start

Claude와의 통합

claude_desktop_config.json 에 다음을 추가하세요:

"vibe-check": { "command": "node", "args": [ "/path/to/vibe-check-mcp/build/index.js" ], "env": { "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY" } }

환경 구성

프로젝트 루트에 .env 파일을 만듭니다.

GEMINI_API_KEY=your_gemini_api_key_here

에이전트 프롬프트 가이드

효과적인 패턴 인터럽트를 위해 시스템 프롬프트에 다음 지침을 포함하세요.

As an autonomous agent, you will: 1. Treat vibe_check as a critical pattern interrupt mechanism 2. ALWAYS include the complete user request with each call 3. Specify the current phase (planning/implementation/review) 4. Use vibe_distill as a recalibration anchor when complexity increases 5. Build the feedback loop with vibe_learn to record resolved issues

각 도구를 사용하는 시기

도구언제 사용할 것인가
🛑 바이브 체크에이전트가 Todo 앱에 대한 블록체인 기본 사항을 설명하기 시작할 때
vibe_distill에이전트의 계획에 전체 기술 사양보다 중첩된 요점이 더 많은 경우
🔄 바이브런복잡성의 심연에서 에이전트를 수동으로 조종한 후

API 참조

전체 API 문서는 기술 참조 에서 확인하세요.

건축학

Vibe Check는 재귀적 감독 원칙을 기반으로 이중 계층 메타인지 아키텍처를 구현합니다. 주요 통찰력:

  1. 패턴 관성 저항 : LLM 에이전트는 추론 경로에서 자연스럽게 모멘텀과 유사한 속성을 보이므로 방향을 바꾸기 위해 외부 개입이 필요합니다.
  2. 위상 공명 방해 : 메타인지적 질문은 최대의 교정 효과를 얻기 위해 에이전트의 현재 단계(계획/구현/검토)와 일치해야 합니다.
  3. 권한 구조 통합 : 에이전트는 외부 메타인지 피드백을 선택적인 제안이 아닌 최우선순위 방해로 처리하도록 명시적으로 촉구받아야 합니다.
  4. 앵커 압축 메커니즘 : 복잡한 추론 흐름은 효과적인 재조정 지점 역할을 하기 위해 최소한의 앵커 체인으로 정제되어야 합니다.
  5. 재귀적 피드백 루프 : 관찰된 모든 실수는 저장되어야 하며, 이를 활용하여 인터럽트 효율성을 개선하는 종단적 실패 모델을 구축해야 합니다.

기본 설계 원칙에 대한 자세한 내용은 철학을 참조하세요.

Vibe Check 실행 (계속)




선적 서류 비치

문서설명
에이전트 프롬프팅 전략에이전트 통합을 위한 세부 기술
고급 통합피드백 체이닝, 신뢰 수준 등
기술 참조완전한 API 문서
철학Vibe Check의 더 심층적인 AI 정렬 원리
사례 연구Vibe Check의 실제 사례

기여하다

Vibe Check에 기여해 주세요! 버그 수정, 기능 추가, 문서 개선 등 어떤 참여든 시작하려면 기여 가이드라인을 확인하세요.

특허

MIT

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

외부 검증, 단순화 지침, 학습 메커니즘을 제공하여 AI 보조자가 추론 경로를 지나치게 복잡하게 만드는 것을 방지하는 데 도움이 되는 메타인지 패턴 인터럽트 시스템입니다.

  1. What is Vibe Check?
    1. The Problem: Pattern Inertia
      1. Features: Metacognitive Oversight Tools
        1. 🛑 vibe_check
        2. ⚓ vibe_distill
        3. 🔄 vibe_learn
        4. Vibe Check in Action
      2. Installation & Setup
        1. Installing via Smithery
        2. Manual Installation via npm (Recommended)
      3. Integration with Claude
        1. Environment Configuration
          1. Agent Prompting Guide
            1. When to Use Each Tool
              1. API Reference
                1. Architecture
                  1. Vibe Check in Action (Continued)
                    1. Documentation
                      1. Contributing
                        1. License
                          ID: 0ubpv1yc35