better-bear について
better-bear は、Bear のノートを CloudKit 経由で読み書きする MCP サーバー兼コマンドラインツールです。Bear のライブラリを Claude から扱いたい利用者に向いています。
主な機能
- 01CloudKit 経由の Bear ノートへのアクセス
- 0234 個の MCP ツール
- 03ノートの検索・作成・編集
- 04タグと添付ファイルの管理
- 05同期されるコンテキストライブラリ
活用シーン
- 01Claude による Bear ノートの検索と整理
- 02#context タグ付きノートのフォルダへの同期
- 03コマンドラインからのノートの一括管理
MCP 対応
better-bear は Claude Desktop と Claude Code に対し、ノート、タグ、TODO、添付ファイル、コンテキストライブラリを扱う 34 個の MCP ツールを提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
35掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| tag | string | いいえ | タグでノートを絞り込みます(部分一致)。 |
| limit | number | いいえ | 返すノートの最大数(デフォルトは 30) |
| include_trashed | boolean | いいえ | ゴミ箱に移動したノートを結果に含めます |
| include_archived | boolean | いいえ | アーカイブ済みのノートを結果に含めます |
詳細
better bear
CloudKit 経由で Bear のノートを扱う MCP サーバーと CLI です。LLM が利用しやすいように最適化された、厳選・同期済みのノートフォルダーであるコンテキストライブラリも含まれています。Karpathy の 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をご覧ください。
MCP ツール
ノート、タグ、TODO、添付ファイル、検索、フロントマター、統計、ヘルスチェック、コンテキストライブラリを扱う34個のツールがあります。一覧については、MCP サーバーの READMEをご覧ください。
コントリビューター
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。