Bear笔记集成服务

更好的熊mcp

MCP服务器，允许克劳德访问您的熊笔记。

由...驱动 更好的熊cli （bcli），它将贝尔斯登的票据操作暴露为stdio传输上的MCP工具。

先决条件

• macOS（Bear仅适用于macOS）
• 熊 安装时启用了iCloud同步
• Node.js 20+
• iCloud帐户（用于CloudKit身份验证）

安装

适用于Claude Desktop用户 --只需在下面添加配置即可。 npx 处理其余的。

发展：

git clone https://github.com/darronz/better-bear-mcp.git
cd better-bear-mcp
npm install
npm run build

认证

Bear通过CloudKit在iCloud中存储笔记。要访问它们，bcli需要来自Apple登录的一次性CloudKit身份验证令牌。

设置

1. 跑 bcli auth 在终端中
2. 打开Apple登录的浏览器窗口——使用您的iCloud帐户登录
3. 完成后，终端显示“已成功验证”
4. 令牌保存在 ~/.config/bear-cli/auth.json 并在会话中持续存在

替代方案：从Claude处进行身份验证

这 bear_auth MCP工具可以直接从Claude对话中触发身份验证。它在不离开聊天的情况下打开相同的浏览器流。

无头/SSH环境

如果您通过SSH运行（没有可用的浏览器），请直接使用令牌进行身份验证：

bcli auth --token '<your-ckWebAuthToken>'

令牌到期

如果Bear操作开始失败，出现“未通过身份验证”或“身份验证令牌过期”错误，请重新运行 bcli auth 或使用 bear_auth 工具。

Claude桌面设置

将此添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "better-bear": {
      "command": "npx",
      "args": ["-y", "better-bear-mcp"]
    }
  }
}

编辑配置后重新启动Claude Desktop。

为了地方发展，直接使用构建的输出：

{
  "mcpServers": {
    "better-bear": {
      "command": "node",
      "args": ["/absolute/path/to/better-bear-mcp/dist/index.js"]
    }
  }
}

可用工具

故障排除

“未通过身份验证”或“身份验证令牌已过期” 跑 bcli auth 在终端中或使用 bear_auth 工具。

Claude Desktop找不到服务器 检查Node.js是否在您的PATH中。这 npx 建议使用这种方法——它会自动处理安装。

“未找到bcli二进制文件” 跑 npm install 触发下载bcli的安装后脚本。

许可证

麻省理工学院