Bear 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

前提条件

• 安装了 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 助手显示具有特定标签的笔记：

显示我所有带有 #work 标签的笔记

高级选项

如果您的 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 文件。