Bear MCP Server

这是一个模型上下文协议（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

预备条件

• 已安装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助手查找包含特定词条的笔记：

你能找到我所有的关于“项目管理”的笔记吗？

打开特定笔记

让您的AI助手通过标题检索特定笔记：

给我看标题为“会议记录 - 2025年3月”的笔记

查看标签

让您的AI助手列出您所有的Bear标签：

我在Bear笔记中有哪些标签？

查找具有特定标签的笔记

让您的AI助手显示具有特定标签的所有笔记：

给我看所有带有#工作标签的笔记

高级选项

如果您的Bear数据库位于非标准位置：

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

技术细节

只读实现

此MCP服务器使用严格的只读连接连接到您的Bear SQLite数据库。这在数据库驱动程序级别强制执行：

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

这确保了：

• 无法对您的数据库执行写入操作
• 您的笔记和标签不会被修改、删除或损坏
• 如果尝试写入权限，数据库连接将失败

此服务器执行的所有操作都是仅检索数据而不对其进行修改的SELECT查询。

许可证

本项目采用MIT许可证——详情见LICENSE文件。