My Bear MCP Server

🚀 熊 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を利用し、Claude などの AI アシスタントが Bear ノートアプリからノートを読み取れるようにします。この実装では、Bear の SQLite データベースに直接接続し、読み取り専用モードで動作するため、ノートが安全に保たれ、変更されることはありません。

🚀 クイックスタート

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

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

完了です！サーバーが起動し、あなたの Bear データベースに接続します。

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

# リポジトリをクローン
git clone https://github.com/bart6114/my-bear-mcp-server.git
cd my-bear-mcp-server

# 依存関係をインストール
npm install

# ビルドして起動
npm run build
npm start

📋 前提条件

• macOS システムに Bear アプリケーションがインストールされていること
• 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": []
    }
  }
}

💻 使用例

基本的な使用法

# オプション 1: GitHub からのインストール
npx github:bart6114/my-bear-mcp-server

# オプション 2: クローンしてローカルで実行
git clone https://github.com/bart6114/my-bear-mcp-server.git
cd my-bear-mcp-server
npm install
npm run build
npm start

高度な使用法

# 非標準パスの Bear データベースを指定する場合
npm start -- --db-path "/path/to/database.bear"

✨ 主な機能

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

• open_note：タイトルまたは ID でノートを開きます。
• search_notes：用語またはキーワードでノートを検索します。
• get_folder_notes：指定されたフォルダ内のすべてのノートを取得します。
• list_folders：利用可能なすべてのフォルダをリストします。

🔧 技術詳細

サーバーは読み取り専用接続で Bear の SQLite データベースにアクセスし、データの安全性と整合性を確保します。以下は実装のキーとなるコード例です。

// 読み取り専用データベース接続
const db = new Database('file:/path/to/database.bear?mode=ro');

// すべてのノートを取得
async function getAllNotes() {
  const result = await db.query(
    'SELECT * FROM notes'
  );
  return result;
}

📦 インストール位置

Bear データベースが非標準パスにある場合は、以下のコマンドで指定できます。

npm start -- --db-path "/path/to/database.bear"

👥 貢献者

• bart6114 - プロジェクト作者
• contributor-name - その他の貢献者

📄 ライセンス

MIT License

このサーバーは、AI アシスタントが安全かつ効率的に Bear ノートにアクセスできるようにすることを目的としています。詳細については、プロジェクトのドキュメントを参照するか、問題を提出してください。