Vibe Board MCP (ve-vibe-board)

Ваш агент, который помнит всё. MCP-сервер на базе Firestore, который дает Claude Code (и любому агенту, поддерживающему MCP) постоянную память между сессиями — задачи, прогресс, решения и заметки о передаче дел, которые сохраняются после сжатия контекста и завершения сессии.

Сопутствующий репозиторий: HuntsDesk/ve-kit — Vibe Coding Framework и постоянная память для Claude Code. ve-kit объединяет этот MCP-сервер, рабочий процесс RIPER-CAT, хуки для проверки (review-gate) и опциональный Docker-воркер.

Часть Vibe Entrepreneurs — сообщества для всех «вайб-кодеров», создающих реальные продукты с помощью ИИ. Приходите поздороваться: vibeentrepreneurs.com.

Почему это существует

Звучит знакомо?

• Вы выполнили шесть вызовов инструментов для рефакторинга. Контекст сжался. Агент возвращается с «вайбом», но без плана.

• Вы начинаете новую сессию завтра. Он снова читает те же файлы, снова задает те же вопросы, снова принимает решения, которые вы уже приняли.

• Вы видели, как он написал идеальный список TodoWrite — затем разговор закончился, и список испарился вместе с ним.

• Вы открыли трех агентов параллельно. Ни один из них не знает, что сделали другие.

Вот как выглядит отсутствие состояния на практике. Агент великолепен в течение часа, а затем страдает амнезией навсегда.

Vibe Board — это место, где хранится состояние. Это общая доска задач и сессий, которая существует вне любого отдельного разговора — в Firestore, а не в контексте.

• Агенты создают задачи во время планирования — они сохраняются после сессии

• Прогресс отслеживается во время выполнения — виден для следующего запуска

• Заметки о передаче дел пишутся при завершении сессий — со ссылками на конкретные открытые задачи

• Следующая сессия вызывает board_create_session, считывает передачу и возобновляет работу с того места, где остановилась предыдущая

Что вы получаете: агент, который во вторник знает, что он делал в понедельник. Никаких повторных объяснений. Никаких потерянных планов. Никакого кладбища TodoWrite.

Бесплатно при использовании на бесплатном тарифе Firebase.

14 инструментов MCP

Четырнадцать инструментов, одна задача: дать агенту место для хранения состояния, которое не является самим разговором.

Установка

1. Клонирование и сборка

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

2. Настройка Firebase

Создайте проект Firebase (подходит бесплатный тариф). Включите Firestore в режиме Native. Создайте сервисную учетную запись с ролью roles/datastore.user и скачайте JSON-ключ.

GOOGLE_APPLICATION_CREDENTIALS принимает либо путь к файлу JSON-ключа (канонический способ), либо необработанное содержимое JSON (удобно для изолированных сред, таких как браузерный MCP Inspector в Glama, секреты 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.

Связанные проекты

• HuntsDesk/ve-kit — полный Vibe Coding Framework, включающий этот MCP-сервер

• HuntsDesk/ve-gws — VE Google Workspace MCP (родственный проект в семействе ve-*)