better bear

better-bear MCP server

Build Release npm License: MIT better-bear MCP server Buy Me A Coffee

CloudKit을 통해 Bear 노트를 관리하는 MCP 서버 및 CLI입니다. Karpathy의 LLM 지식 베이스 패턴에서 영감을 받아 LLM 사용에 최적화된, 큐레이팅되고 동기화되는 노트 폴더인 **컨텍스트 라이브러리(context library)**를 포함합니다.

전체 문서: better-bear.com

설치

CLI를 설치한 후 Claude에 연결하세요:

curl -sL https://raw.githubusercontent.com/KuvopLLC/better-bear/main/install.sh | bash
bcli auth
bcli mcp install

이 과정은 bcli 바이너리를 설치하고, iCloud 인증을 수행하며, Claude Desktop( .mcpb 번들 사용) 및 Claude Code 모두를 위한 MCP 서버를 설정합니다.

기타 설치 방법

방법	명령어
Claude Desktop 전용	`bcli mcp install --desktop-only`
Claude Code 전용	`bcli mcp install --code-only`
Claude Code (직접)	`claude mcp add better-bear -- npx -y better-bear`
설정 파일	`bcli mcp install --json`
.mcpb 번들	최신 릴리스에서 다운로드 후 더블 클릭

관리

bcli mcp status      # check what's configured
bcli mcp uninstall   # remove from Claude Desktop and Claude Code
bcli mcp reinstall   # clean uninstall + install
bcli upgrade         # upgrade bcli binary

CLI

모든 명령어는 터미널에서 독립적으로 실행할 수도 있습니다:

bcli ls                          # list notes
bcli search "query"              # full-text search
bcli create "Title" -b "Body"    # create a note
bcli edit <id> --append "text"   # append to a note
bcli tags                        # list all tags
bcli attach <id> photo.jpg       # attach a file
bcli stats                       # library statistics
bcli health                      # health check

전체 명령어 참조는 better-bear.com을 확인하세요.

컨텍스트 라이브러리

Bear 노트의 일부를 Claude가 인덱스 우선 검색을 사용하여 탐색할 수 있는 동기화된 큐레이팅 컨텍스트 폴더로 전환하세요. Bear에서 노트에 #context 태그를 지정하고 동기화하면, Claude는 압축된 인덱스를 읽어 관련 파일을 찾습니다. 즉, 모든 파일을 로드하는 대신 필요한 파일만 로드합니다.

bcli context init                          # one-time setup
bcli context sync                          # pull qualifying notes
bcli context add <id> --subtag research    # tag a note for inclusion
bcli context status                        # health check

또는 Claude에게 *"컨텍스트 라이브러리 설정해줘(Set up a context library)"*라고 말하면 MCP 도구를 통해 모든 것을 처리합니다.

이 아키텍처는 Karpathy의 3개 폴더 패턴을 따릅니다: bear/ (CloudKit에서 동기화), external/ (PDF, 내보내기, 공유 문서), inbox/ (분류를 위한 드롭 존). index.md 매니페스트가 모든 것을 매핑합니다. 전체 문서는 better-bear.com을 참조하세요.