Bear MCP Server

Bear MCP 服务

一个模型上下文协议（MCP）服务，可让 Claude 等 AI 助手读取 Bear 笔记应用中的笔记。本实现以只读模式直接连接 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 数据库）：

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"

查看标签

请 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 文件。