My Bear MCP Server

🚀 熊 MCP 服務器

熊 MCP 服務器是一個模型上下文協議（MCP）服務器，它允許像克萊奧這樣的 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

✨ 主要特性

• 允許 AI 助手（如克萊奧）從 Bear 筆記應用程序中讀取筆記。
• 以只讀模式連接到 Bear 的 SQLite 數據庫，確保筆記安全，不會被修改。

📦 安裝指南

先決條件

• 需在 macOS 系統上安裝 Bear 應用程序。
• 需安裝 Node.js 18 或更高版本。

配置

對於克萊奧桌面應用程序

將以下內容添加到配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json 中：

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

對於克萊奧 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 數據庫）：

• 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 筆記訪問方式。如需更多信息，請參考項目文檔或提交問題。