Bear MCP Server

Bear MCP サーバー

Claude のような AI アシスタントが、Bear メモアプリのノートを読み取れるようにする Model Context Protocol（MCP）サーバーです。この実装は Bear の SQLite データベースに読み取り専用モードで直接接続するため、ノートは安全に保たれ、変更されることはありません。

クイックスタート

オプション 1：GitHub からインストール（推奨）

npx github:bart6114/my-bear-mcp-server

これで完了です！サーバーが起動し、Bear データベースに接続します。

オプション 2：クローンしてローカルで実行

# Clone the repository
git clone https://github.com/bart6114/my-bear-mcp-server.git
cd my-bear-mcp-server

# Install dependencies
npm install

# Build and run
npm run build
npm start

前提条件

• Bear アプリがインストールされた macOS
• Node.js 18 以降

設定

Claude Desktop アプリの場合

設定ファイル ~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "bear": {
      "command": "npx",
      "args": ["github:bart6114/my-bear-mcp-server"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude VS Code 拡張機能の場合

設定ファイル ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json に以下を追加します。

{
  "mcpServers": {
    "bear": {
      "command": "npx",
      "args": ["github:bart6114/my-bear-mcp-server"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

利用可能なツール

Bear MCP サーバーは、以下の読み取り専用ツールを提供します（すべての操作は非破壊的で、Bear データベースを変更できません）。

open_note

タイトルまたは ID でノートを開きます。

search_notes

用語またはタグでノートを検索します。

get_tags

Bear のすべてのタグを取得します。

open_tag

特定のタグが付いたすべてのノートを表示します。

使用例

AI アシスタントを通じて Bear MCP ツールを操作する方法の例を紹介します。

ノートを検索する

特定の用語を含むノートを検索するよう、AI アシスタントに依頼します。

Can you find all my notes about "project management"?

特定のノートを開く

タイトルを指定して特定のノートを取得するよう、AI アシスタントに依頼します。

Show me my note titled "Meeting Notes - March 2025"

タグを表示する

Bear のすべてのタグを一覧表示するよう、AI アシスタントに依頼します。

What tags do I have in my Bear notes?

特定のタグが付いたノートを検索する

特定のタグが付いたノートを表示するよう、AI アシスタントに依頼します。

Show me all notes with the #work tag

詳細オプション

Bear データベースが標準以外の場所にある場合：

npx github:bart6114/my-bear-mcp-server --db-path /path/to/your/database.sqlite

技術的な詳細

読み取り専用の実装

この MCP サーバーは、厳格な読み取り専用接続を使用して Bear の SQLite データベースに接続します。これはデータベースドライバーのレベルで強制されます。

// From src/bear-db.ts
this.db = new Database(dbPath, { readonly: true });

これにより、以下が保証されます。

• データベースに対する書き込み操作は実行できません
• ノートやタグが変更、削除、破損されることはありません
• 書き込み権限を使おうとすると、データベース接続は失敗します

このサーバーが実行する操作はすべて SELECT クエリであり、データを変更せずに取得するだけです。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。