Skip to main content
Glama
deenesjakoruzh
himanshu-sharma-55

workbrain

by himanshu-sharma-55
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Workbrain

AI 지원 작업을 위한 개인 운영 레이어.

Workbrain은 Claude Code용 로컬 Model Context Protocol (MCP) 서버입니다. Claude에게 작업 방식, 이번 주 집중 사항, 그리고 배포한 내용에 대한 지속적인 컨텍스트를 제공합니다 — 데이터를 클라우드로 보내거나 팀과 공유하지 않고도 말이죠.

개요

대부분의 AI 코딩 설정은 모델에게 어떻게 행동해야 하는지 (규칙, 프롬프트)를 알려줍니다. Workbrain은 무엇을 하고 있는지를 알려주고 — 작업하면서 그 그림을 최신 상태로 유지하게 합니다.

레이어

저장 내용

예시

Playbook

작업 방식

버그 수정 접근법, 커뮤니케이션 스타일

Agenda

집중하고 있는 사항

이번 주 우선순위와 산출물

Work log

배포한 내용

아젠다 항목에 연결된 요약

Commits

원시 git 활동

선택적 훅을 통해 자동 캡처

모든 것은 ~/.workbrain/에 로컬로 저장됩니다. 선택하지 않는 한 프로젝트 저장소에 커밋되지 않습니다.

Related MCP server: Melchizedek

기능

  • 통합 컨텍스트 — get_context는 playbook, agenda, work log, commits를 한 번의 호출로 반환합니다

  • 살아있는 주간 보드 — Claude는 세션 중에 아젠다 항목을 추가, 업데이트, 완료할 수 있습니다

  • 자동 작업 기록 — 아젠다 항목을 완료로 표시하면 연결된 작업 로그 항목이 생성됩니다

  • 로컬 우선 및 프라이빗 — 디스크의 SQLite + markdown; 계정 없음, 클라우드 동기화 불필요

  • 프로젝트 간 — 사용자 범위로 등록; 모든 저장소에서 사용 가능

  • Git 통합 — 선택적 post-commit 훅이 커밋을 자동으로 기록합니다

  • CLI — Claude를 열지 않고 터미널에서 주간 상태 확인

요구 사항

  • Node.js 22+ (내장 node:sqlite 사용 — 네이티브 의존성 없음)

  • Claude Code CLI 또는 확장 (Cursor, VS Code, 또는 터미널)

빠른 시작

git clone https://github.com/himanshu-sharma-55/work-brain.git
cd work-brain
npm install
node bin/install.js

MCP 서버 등록 (서버 이름은 workbrain; 저장소 폴더는 work-brain):

claude mcp add --scope user workbrain -- node /absolute/path/to/work-brain/src/index.js

셸 프로필 (~/.zshrc 또는 ~/.bashrc)에 추가:

export WORKBRAIN_ROOT=/absolute/path/to/work-brain

Claude Code에서 확인: /mcp를 입력하고 workbrain이 연결되었는지 확인하세요.

playbook 편집: ~/.workbrain/playbook.md

작동 방식

┌─────────────────────────────────────────────────────────┐
│                     Claude Code                         │
│              (Cursor / VS Code / CLI)                   │
└────────────────────────┬────────────────────────────────┘
                         │ MCP (stdio)
                         ▼
┌─────────────────────────────────────────────────────────┐
│                  Workbrain Server                       │
│  get_context · get_agenda · log_work · get_commits …   │
└────────────────────────┬────────────────────────────────┘
                         │
          ┌──────────────┼──────────────┐
          ▼              ▼              ▼
   playbook.md       data.db      git hook (optional)
   (how you work)   (agenda,       (commit capture)
                     work log,
                     commits)
          └──────────────┴──────────────┘
                         │
                    ~/.workbrain/
                    (or WORKBRAIN_HOME)

Claude는 필요할 때 Workbrain 도구를 호출합니다 — 규칙이 모든 메시지에 로드되지 않아 필요할 때까지 컨텍스트를 가볍게 유지합니다.

MCP 도구

도구

설명

get_context

권장 진입점. Playbook, 현재 아젠다, 최근 작업 로그, 커밋

get_playbook

개인 playbook 읽기

update_playbook

playbook 교체 또는 추가

get_agenda

주간 보드: 집중 사항, 예정, 기대 사항

add_agenda_item

보드에 항목 추가

update_agenda_item

상태, 제목, 예상 시간 등 업데이트. 완료로 표시하면 자동으로 작업 기록

delete_agenda_item

아젠다 항목 제거

rollover_agenda

지난 주의 미완료 항목을 이번 주로 이동

get_weekly_summary

특정 주의 아젠다 통계, 작업 로그, 커밋

get_work_log

최근 작업 요약

log_work

배포한 내용 기록 (선택적으로 아젠다 항목에 연결)

get_commits

git 훅이 캡처한 최근 커밋

권장 세션 흐름

개인 Cursor 또는 Claude 규칙에 추가:

작업 세션 시작 시 get_context를 호출하세요. 명확한 작업을 완료하면 아젠다를 업데이트하고 작업을 기록하세요. 아젠다 항목을 완료로 표시하는 것만으로 충분합니다 — 자동으로 기록됩니다.

예시 프롬프트

사용자 입력

Workbrain 동작

"이번 주 집중 사항이 뭐야?"

get_context 호출

"CSV 내보내기를 진행 중으로 표시해"

update_agenda_item 호출

"이번 주에 뭐 배포했어?"

get_weekly_summary 호출

"미완료 항목 이월해"

rollover_agenda 호출

"보통 버그를 어떻게 고쳐?"

playbook 읽기

CLI

Claude 없이 상태 확인:

node bin/workbrain.js status     # current week at a glance
node bin/workbrain.js summary    # full week recap
npm run status                   # shortcut via package script

구성

환경 변수

변수

기본값

설명

WORKBRAIN_HOME

~/.workbrain

데이터 디렉터리 (playbook, 데이터베이스)

WORKBRAIN_ROOT

—

work-brain 저장소 경로; git 훅에 필요

데이터 디렉터리 구조

~/.workbrain/
├── playbook.md    # How you work (markdown)
├── data.db        # Agenda, work log, commits (SQLite)
└── git-template/  # Git hook template (created by install)

사용자 지정 데이터 디렉터리

export WORKBRAIN_HOME=/path/to/shared/workbrain-data
claude mcp add --scope user workbrain -- \
  env WORKBRAIN_HOME=/path/to/shared/workbrain-data \
  node ~/work-brain/src/index.js

Git 통합

node bin/install.js는 전역 git 템플릿을 구성하여 새 저장소에 post-commit 훅이 자동으로 포함되도록 합니다.

기존 저장소의 경우:

export WORKBRAIN_ROOT=/path/to/work-brain   # in ~/.zshrc
node /path/to/work-brain/bin/setup-git-hook.js /path/to/repo

각 커밋은 해시, 저장소, 브랜치, 메시지, 변경된 파일을 ~/.workbrain/data.db에 기록합니다.

다중 머신 설정

각 머신에서 클론 및 등록:

git clone https://github.com/himanshu-sharma-55/work-brain.git ~/work-brain
cd ~/work-brain && npm install && node bin/install.js
claude mcp add --scope user workbrain -- node ~/work-brain/src/index.js

각 머신은 기본적으로 자체 ~/.workbrain/을 유지합니다. 데이터 동기화 방법:

방법

접근 방식

클라우드 폴더

~/.workbrain을 iCloud, Dropbox 등에 심볼릭 링크

Dotfiles 저장소

playbook.md 추적; data.db 주기적으로 복사

공유 경로

두 머신 모두에서 WORKBRAIN_HOME을 동일한 위치로 설정

Cursor 설정

Workbrain은 Cursor의 ~/.cursor/mcp.json이 아닌 Claude Code MCP를 사용합니다.

  1. Cursor에 Claude Code 확장 설치

  2. 통합 터미널 열기

  3. claude mcp add 실행 (빠른 시작 참조)

  4. Claude 패널에서: /mcp → workbrain 활성화

개인정보 및 범위

Workbrain은 개인 사용을 위해 설계되었습니다:

  • MCP는 --scope user로 등록 — 프로젝트 저장소에 연결되지 않음

  • 직접 동기화하지 않는 한 개인 데이터는 머신을 벗어나지 않습니다

  • .mcp.json을 공유 팀 저장소에 커밋하지 마세요

문제 해결

문제

해결 방법

claude 명령을 찾을 수 없음

Claude Code CLI 설치 또는 확장 터미널 사용

/mcp에서 서버 누락

claude mcp add --scope user workbrain -- node /path/to/work-brain/src/index.js 다시 실행

저장소 이동 후 경로 깨짐

claude mcp remove workbrain 실행 후 업데이트된 경로로 다시 추가

커밋이 기록되지 않음

echo $WORKBRAIN_ROOT 및 .git/hooks/post-commit 존재 확인

서버가 시작되지 않음

node src/index.js 수동 실행; Node 버전 확인 (node -v ≥ 22)

개발

npm install
npm start              # run MCP server (stdio)
npm run install:local  # install + init data dir + git template
npm run status         # CLI status check

전역 CLI 별칭으로 로컬 개발:

cd work-brain && npm link
claude mcp add --scope user workbrain -- workbrain

명명

이름

용도

work-brain

GitHub 저장소 및 로컬 클론 디렉터리

workbrain

MCP 서버 이름, npm 패키지, 데이터 디렉터리 (~/.workbrain)

WORKBRAIN_*

환경 변수 접두사

라이선스

LICENSE

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Memory MCP Server

    michael-denyer
    A
    license
    B
    quality
    A
    maintenance
    Provides a persistent "second brain" for Claude featuring zero-latency hot caching, semantic cold storage, and automatic pattern mining from activity logs. It enables users to store, search, and automatically extract project facts and code patterns for enhanced contextual recall.
    56
    7
    MIT

  • Melchizedek

    louis49
    A
    license
    A
    quality
    B
    maintenance
    Persistent memory for Claude Code. Automatically indexes every conversation and provides production-grade hybrid search (BM25 + vectors + reranker) via MCP tools. 100% local, zero config, zero API keys, zero invoice.
    16
    55
    7
    MIT

View all related MCP servers

Related MCP Connectors

  • Threadminder

    Persistent context for Claude. Your AI always knows your projects and next actions across sessions.

  • Rootr

    Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.

  • Umtri

    Give your AI agent a persistent map of your project's structure, dependencies, and bugs.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/himanshu-sharma-55/work-brain'

If you have feedback or need assistance with the MCP directory API, please join our Discord server