Bear MCP Server

Bear MCP Server

site icon
2025.03.14 3
JavaScript笔记管理AI 助手集成交流协作
Bear MCP Server 是一个 Model Context Protocol (MCP) 服务器,允许 AI 助手(如 Claude)从 Bear 笔记应用中读取笔记。该实现直接连接到 Bear 的 SQLite 数据库,并以只读模式运行,确保用户的笔记不会被修改或损坏。
View on GitHub

Overview

基本能力

产品定位

Bear MCP Server 是一个专门为 Bear 笔记应用设计的 MCP 服务器,旨在为 AI 助手提供读取 Bear 笔记的能力。

核心功能

  1. 只读访问:以只读模式连接到 Bear 的 SQLite 数据库,确保数据安全。
  2. 笔记检索:支持通过标题或 ID 打开笔记。
  3. 笔记搜索:支持通过关键词或标签搜索笔记。
  4. 标签管理:获取所有标签或查看特定标签下的笔记。

适用场景

  1. AI 助手集成:允许 AI 助手(如 Claude)读取用户的 Bear 笔记,提供更智能的交互体验。
  2. 笔记管理:通过 AI 助手快速检索和管理笔记,提高工作效率。

工具列表

  1. open_note:通过标题或 ID 打开笔记。
  2. search_notes:通过关键词或标签搜索笔记。
  3. get_tags:获取所有标签。
  4. open_tag:查看特定标签下的所有笔记。

常见问题解答

  1. 如何确保数据安全?:服务器以只读模式连接数据库,所有操作均为 SELECT 查询,不会修改数据。
  2. 如何指定非标准数据库路径?:使用 --db-path 参数指定数据库路径。

使用教程

使用依赖

  1. macOS:需安装 Bear 应用。
  2. Node.js:需安装 Node.js 18 或更高版本。

安装教程

选项 1:从 GitHub 安装(推荐)

npx github:bart6114/my-bear-mcp-server

选项 2:克隆并本地运行

git clone https://github.com/bart6114/my-bear-mcp-server.git
cd my-bear-mcp-server
npm install
npm run build
npm start

调试方式

  1. Claude 桌面应用:在配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加 MCP 服务器配置。
  2. Claude VS Code 扩展:在配置文件 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 中添加 MCP 服务器配置。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。