Vibe Board MCP (ve-vibe-board)

Name: Vibe Board VE
Author: HuntsDesk

MCP server on Glama

기억하는 에이전트. Claude Code(및 모든 MCP 지원 에이전트)에 세션 간 지속적인 메모리를 제공하는 Firestore 기반 MCP 서버입니다. 컨텍스트 압축이나 세션 종료 후에도 작업, 진행 상황, 결정 사항 및 핸드오프 메모가 유지됩니다.

관련 저장소: HuntsDesk/ve-kit — Claude Code를 위한 Vibe Coding 프레임워크 및 지속적 메모리. ve-kit은 이 MCP 서버, RIPER-CAT 워크플로우, 검토 게이트 훅 및 선택적 Docker 워커를 번들로 제공합니다.

Vibe Entrepreneurs의 일부 — AI와 함께 실제 작업을 수행하는 바이브 코더들을 위한 커뮤니티입니다. 인사하러 오세요: vibeentrepreneurs.com.

왜 이 도구가 필요한가요?

익숙한 상황인가요?

리팩토링을 위해 6번의 도구 호출을 수행했습니다. 컨텍스트가 압축됩니다. 에이전트가 돌아오지만 계획은 사라졌습니다.
내일 새로운 세션을 시작합니다. 에이전트는 같은 파일을 다시 읽고, 같은 질문을 다시 하며, 이미 결정한 사항을 다시 결정합니다.
완벽한 TodoWrite 체크리스트를 작성하는 것을 보았지만, 대화가 종료되자 체크리스트도 함께 사라졌습니다.
세 개의 에이전트를 병렬로 열었습니다. 서로 무엇을 했는지 아무도 모릅니다.

이것이 실제 환경에서 상태 비저장(statelessness)이 의미하는 바입니다. 에이전트는 한 시간 동안은 뛰어나지만 그 이후에는 기억상실증에 걸립니다.

Vibe Board는 상태가 저장되는 곳입니다. 대화 컨텍스트가 아닌 Firestore에 위치하며, 단일 대화에 종속되지 않는 공유 작업 및 세션 보드입니다.

에이전트가 계획 단계에서 작업을 생성하면 세션이 종료되어도 유지됩니다.
실행 중에 진행 상황이 추적되며 다음 실행 시에도 확인 가능합니다.
세션 종료 시 핸드오프 메모가 작성되며, 미완료 작업에 대한 참조가 포함됩니다.
다음 세션에서 board_create_session을 호출하면 핸드오프를 읽고 마지막에 중단된 지점부터 재개합니다.

결과적으로 화요일에 월요일에 무엇을 하고 있었는지 기억하는 에이전트를 얻게 됩니다. 다시 설명할 필요도, 계획을 잃어버릴 일도, TodoWrite의 무덤도 없습니다.

Firebase 무료 티어에서 무료로 실행할 수 있습니다.

14개의 MCP 도구

카테고리	도구
프로젝트	`board_get_projects`, `board_create_project`, `board_update_project`
작업	`board_get_tasks`, `board_get_task`, `board_create_task`, `board_update_task` (프로젝트 간 이동 지원), `board_bulk_update_tasks` (한 번에 1-100개), `board_delete_task` (안전 장치 포함)
세션	`board_create_session` (마지막 세션의 핸드오프 반환), `board_end_session`, `board_get_handoff`
활동	`board_log_activity`, `board_get_activity` (커서 기반 페이지네이션, 필터링 가능)

14개의 도구, 하나의 목적: 에이전트에게 대화 내용이 아닌 곳에 상태를 저장할 공간을 제공합니다.

설치

1. 복제 및 빌드

git clone https://github.com/HuntsDesk/ve-vibe-board.git
cd ve-vibe-board
npm install
npm run build

2. Firebase 설정

Firebase 프로젝트를 생성합니다(무료 티어 가능). Native 모드에서 Firestore를 활성화합니다. roles/datastore.user 권한이 있는 서비스 계정을 생성하고 키 JSON을 다운로드합니다.

GOOGLE_APPLICATION_CREDENTIALS는 키 JSON의 파일 경로(표준) 또는 원시 JSON 내용 인라인(Glama의 브라우저 MCP Inspector, CI 시크릿 또는 Cloud Run의 인라인 시크릿 패턴과 같은 샌드박스 환경에 유용)을 허용합니다.

또한 2개의 복합 인덱스를 생성합니다:

gcloud firestore indexes composite create \
  --project=YOUR_PROJECT_ID \
  --collection-group=sessions \
  --field-config field-path=project_id,order=ascending \
  --field-config field-path=status,order=ascending \
  --field-config field-path=ended_at,order=descending

gcloud firestore indexes composite create \
  --project=YOUR_PROJECT_ID \
  --collection-group=tasks \
  --field-config field-path=project_id,order=ascending \
  --field-config field-path=status,order=ascending

인덱스가 빌드될 때까지 1-5분 정도 기다립니다.

3. Claude Code 구성

프로젝트의 .mcp.json에 추가합니다:

{
  "mcpServers": {
    "vibe-board": {
      "command": "node",
      "args": ["/absolute/path/to/ve-vibe-board/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/your-key.json"
      }
    }
  }
}

.claude/settings.local.json에서 도구를 허용합니다:

{
  "permissions": {
    "allow": [
      "mcp__vibe-board__board_get_projects",
      "mcp__vibe-board__board_create_project",
      "mcp__vibe-board__board_update_project",
      "mcp__vibe-board__board_get_tasks",
      "mcp__vibe-board__board_get_task",
      "mcp__vibe-board__board_create_task",
      "mcp__vibe-board__board_update_task",
      "mcp__vibe-board__board_bulk_update_tasks",
      "mcp__vibe-board__board_delete_task",
      "mcp__vibe-board__board_create_session",
      "mcp__vibe-board__board_end_session",
      "mcp__vibe-board__board_get_handoff",
      "mcp__vibe-board__board_log_activity",
      "mcp__vibe-board__board_get_activity"
    ]
  },
  "enabledMcpjsonServers": ["vibe-board"]
}

4. 확인

새로운 Claude Code 세션을 시작하고 board_get_projects를 호출합니다. 빈 배열이 반환되면 성공입니다.

에이전트 규칙 (CLAUDE.md에 붙여넣기)

## Vibe Board

Persistent task tracking across sessions via MCP tools (`board_*`).
**Mandatory for every substantive session.**

### Use board tasks, NOT TodoWrite
TodoWrite is ephemeral — dies when the session ends. Board tasks persist.
When you would reach for TodoWrite to track multi-step work, use
`board_create_task` instead.

### Session lifecycle
1. Call `board_create_session` at session start — returns last session's handoff
2. Create/update board tasks as you work
3. Call `board_end_session` with progress summary + handoff notes before stopping

전체 규칙 세트(사전 예방적 트리거, 프로세스 게이트, 검토 프로토콜)는 HuntsDesk/ve-kit → docs/ve-kit/02-VIBE-BOARD.md에 있습니다.

라이선스

MIT. LICENSE를 참조하세요.

Vibe Board VE

Vibe Board MCP (ve-vibe-board)

왜 이 도구가 필요한가요?

14개의 MCP 도구

설치

1. 복제 및 빌드

2. Firebase 설정

3. Claude Code 구성

4. 확인

에이전트 규칙 (CLAUDE.md에 붙여넣기)

라이선스

관련 항목

Resources

Tools

Latest Blog Posts

MCP directory API