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での利用に最適化されたキュレーション済み同期フォルダであるコンテキストライブラリが含まれています。

完全なドキュメント: 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に「コンテキストライブラリをセットアップして」と伝えると、MCPツール経由ですべてを処理します。

アーキテクチャはKarpathyの3フォルダパターンに従っています：bear/（CloudKitから同期）、external/（PDF、エクスポート、共有ドキュメント）、inbox/（トリアージ用のドロップゾーン）。index.md マニフェストですべてをマッピングします。完全なドキュメントについてはbetter-bear.comを参照してください。