Vibe PM MCP Server

AI 변경 제어 및 복구 인프라

AI가 무엇을 했는지 추적하고, 문제가 생기면 어디서부터 잘못됐는지 찾아냅니다.

30초 시작

npm install -g @vibecodetown/mcp-server

Claude Code 설정

~/.claude/settings.json:

{
  "mcpServers": {
    "vibe-pm": {
      "command": "npx",
      "args": ["-y", "@vibecodetown/mcp-server"]
    }
  }
}

Claude Code 재시작 후 vibe_pm.status, vibe_pm.briefing 등의 도구를 사용할 수 있습니다.

핵심 도구

| 도구 | 설명 | |------|------| | vibe_pm.briefing | 프로젝트 시작 / 아이디어 구조화 | | vibe_pm.status | 현재 상태 요약 | | vibe_pm.get_decision | 결재 조회 (A/B/C 선택지) | | vibe_pm.submit_decision | 결재 제출 | | vibe_pm.create_work_order | 작업 지시서 생성 | | vibe_pm.inspect_code | 코드 검수 + 자동 수정 | | vibe_pm.doctor | 환경 점검 | | vibe_pm.ingress | 컨텍스트 스캔 / 재개 |

아키텍처

Claude Code ←→ MCP Server (TypeScript)
                   ↓
              WorkerManager
                   ↓
    ┌──────────────┼──────────────┐
    ↓              ↓              ↓
  FSWorker    BuildWorker    SearchWorker
  (파일 스캔)   (빌드/테스트)   (웹/레포 검색)

                   ↓
              cockpitd (Rust)
              (AI 조종석, 포트 8790)

환경변수

| 변수 | 기본값 | 설명 | |------|--------|------| | VIBE_PROFILE | all | 도구 프로파일 (mvp/coding/all) | | VIBECODE_HELPER_MODE | bundled | Helper 모드 (off/bundled/cached) | | VIBE_OBSERVER | 1 | Observer 활성화 (0=비활성) | | VIBECODE_DEBUG | - | 디버그 로그 활성화 |

프로파일별 도구 수

| 프로파일 | 도구 수 | 용도 | |---------|:------:|------| | mvp | 8개 | 최소 기능 | | coding | 19개 | 개발 중심 | | all | 23개 | 전체 기능 |

워크플로우

1. vibe_pm.briefing     → "프로젝트 접수했습니다"
2. vibe_pm.get_decision → "결재가 필요합니다" (A/B/C 선택)
3. vibe_pm.submit_decision → "결재 확정했습니다"
4. vibe_pm.create_work_order → "작업 지시서를 뽑았습니다"
5. [구현]
6. vibe_pm.inspect_code → 판정
   → GO    → "✅ 진행 가능"
   → FIX   → "⚠️ 보완 필요" → 수정 후 재검수
   → BLOCK → "❌ 반려" → 결재 단계로 복귀

보안

• 코드 외부 전송 없음
• 모든 분석은 로컬에서 수행
• 런타임 산출물은 runs/ 폴더 (gitignore)

문서

| 문서 | 설명 | |------|------| | Agent Guide | AI 에이전트용 가이드 | | Features | 기능 상세 | | Timeline | 기능 활성화 시점 | | Positioning | FAQ & 비교 |

개발

# 설치
npm ci

# 빌드
npm run build

# 테스트
npm test

# 린트
npm run lint

라이선스

MIT