Bear MCP Server

by bart6114
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Requires macOS with Bear app installed for the MCP server to function properly by connecting to the Bear SQLite database.

  • Connects to the Bear SQLite database in read-only mode to safely retrieve note data without modifying the underlying database.

ベアMCPサーバー

ClaudeのようなAIアシスタントがBearメモアプリのメモを読み取ることを可能にする、モデルコンテキストプロトコル(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デスクトップアプリ

~/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 データベースを変更することはできません)。

オープンノート

タイトルまたは ID でメモを開きます。

検索ノート

用語またはタグでメモを検索します。

タグを取得する

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

オープンタグ

特定のタグが付いたすべてのメモを表示します。

使用例

AI アシスタントを介して Bear MCP ツールと対話する方法の例を次に示します。

ノートの検索

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

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

特定のノートを開く

AI アシスタントにタイトルで特定のメモを取得するように依頼します。

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

タグの表示

AI アシスタントに、Bear タグをすべてリストするように依頼します。

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ファイルを参照してください。

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude のような AI アシスタントが Bear メモ作成アプリから安全な読み取り専用モードでメモを読み取ることができるようにするモデル コンテキスト プロトコル サーバー。

  1. Quick Start
    1. Option 1: Install from GitHub (Recommended)
    2. Option 2: Clone and Run Locally
  2. Prerequisites
    1. Configuration
      1. For Claude Desktop App
      2. For Claude VS Code Extension
    2. Available Tools
      1. open_note
      2. search_notes
      3. get_tags
      4. open_tag
    3. Example Usage
      1. Searching for Notes
      2. Opening a Specific Note
      3. Viewing Tags
      4. Finding Notes with a Specific Tag
    4. Advanced Options
      1. Technical Details
        1. Read-Only Implementation
      2. License
        ID: q04mrxtyp0