AI导哈

Bear笔记管理服务

一个基于Python的MCP服务器，提供对Bear笔记应用的读写访问和管理功能，适用于笔记组织和自动化处理场景。

  • by maxim-ist
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 maxim-ist/mcp-bear

使用说明

MCP熊

基于Python的模型上下文协议（MCP）服务器，提供对 熊笔记.

Bear将笔记存储在SQLite数据库中。此MCP服务器提供对笔记的读写访问。 请参阅：https://bear.app/faq/where-are-bears-notes-located

特性

读取操作

  • 读取Bear SQLite数据库中的所有笔记（活动和存档）
  • 按文本内容、标签或唯一ID搜索笔记
  • 列出所有标签
  • 按特定标签获取笔记
  • 单独获取存档笔记

笔记管理

  • 创建带有标题、内容和标签的新笔记
  • 在现有注释中添加、预置或替换文本
  • 组织存档/取消存档笔记
  • 将笔记移至垃圾箱

标签管理

  • 向现有笔记添加标签
  • 重命名所有笔记中的标签
  • 打开熊，显示带有特定标签的笔记

熊整合

  • 在Bear中打开特定笔记
  • 在Bear应用程序中搜索
  • 所有操作均与Bear的用户界面无缝集成

写操作使用Bear的官方 x-callback-url API 用于安全、可靠的修改。

需求

  • Python 3.10或更高版本（用3.14测试）
  • Bear note应用程序（macOS）
  • 访问Bear数据库

安装

开发设置

# Clone the repository
git clone https://github.com/maxim-ist/mcp-bear.git
cd mcp-bear

# Install dependencies (using mise for Python version management)
mise install
mise exec -- python -m venv .venv
.venv/bin/pip install -e .

通过pip安装（发布时）

pip install mcp-bear

Claude桌面配置

将此添加到您的 claude_desktop_config.json:

直接使用Python

{
  "mcpServers": {
    "bear": {
      "command": "python",
      "args": [
        "-m",
        "mcp_bear.server"
      ],
      "env": {
        "PYTHONPATH": "/Users/YOUR_USERNAME/Work/mcp-bear/src"
      }
    }
  }
}

使用已安装的软件包

{
  "mcpServers": {
    "bear": {
      "command": "mcp-bear"
    }
  }
}

可用工具

服务器启动后，以下MCP工具可用：

读取操作（基本）

  • get_notes：检索所有未存档的笔记
  • get_tags：列出所有标记
  • get_notes_like：搜索包含特定文本的笔记

读取操作（高级）

  • get_note_by_id：通过其唯一标识符获取特定注释
  • get_notes_by_tag：获取带有特定标签的所有笔记
  • get_archived_notes：获取所有存档笔记

笔记管理

  • create_note：使用可选的标题、文本、标签和引脚状态创建新注释
  • add_text：向现有注释添加文本（追加、前置或替换）
  • trash_note：将笔记移到垃圾箱
  • archive_note：存档笔记（从主列表中删除，保持可搜索）
  • unarchive_note：取消存档笔记

标签管理

  • add_tags：向现有注释添加标记
  • open_tag：打开Bear并显示带有特定标签的所有笔记
  • rename_tag：重命名所有笔记中的标记

熊整合

  • open_note：在Bear中打开一个特定的注释
  • search_bear：打开Bear并显示某个术语的搜索结果

所有写入操作都使用Bear的官方 x-callback-url方案，这需要Bear安装并运行。

配置

您可以通过设置以下参数来覆盖默认的Bear数据库路径 DB_ROUTE 环境变量：

export DB_ROUTE="/path/to/custom/database.sqlite"

发展

直接运行服务器

cd /Users/borag/Work/mcp-bear
.venv/bin/python -m mcp_bear.server

MCP检验员测试

# Install the MCP inspector
pip install mcp-inspector

# Run the inspector
mcp-inspector python -m mcp_bear.server

建筑

  • mcp_bear/server.py：主MCP服务器实现
  • mcp_bear/database.py：用于读取操作的SQLite数据库访问
  • mcp_bear/bear_url.py：对写操作执行x-callback-url操作
  • 使用Python的内置 sqlite3 模块（无本机依赖关系）

安全说明

此服务器使用参数化SQL查询来防止SQL注入攻击，改进了原始的TypeScript实现。

许可证

ISC

作者

博拉 贡尔 me@boragonul.com

相关 MCP