笔记管理服务

Bear Notes MCP Server是一个提供笔记搜索、创建和管理功能的协议服务器,允许用户通过Claude Code和其他MCP兼容应用程序直接访问Bear笔记。

  • by davidhollenberger
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 davidhollenberger/bear-notes-mcp

使用说明

Bear Notes MCP服务器

一个模型上下文协议(MCP)服务器,提供对Bear笔记的访问,允许您直接从Claude Code和其他MCP兼容应用程序中搜索、读取、创建和管理Bear笔记。

特性

读取操作(直接SQLite访问)

  • 搜索笔记 -使用可选标签过滤按术语搜索
  • 打开注释 -按ID或标题获取完整的笔记内容
  • 获取标签 -列出所有带有注释计数的标签
  • 开始标签 -获取带有特定标签的所有笔记
  • 获取未标记的笔记 -查找没有任何标签的笔记
  • 获取待办事项笔记 -查找包含待办事项的笔记
  • 获取今天的笔记 -立即创建笔记

写入操作(Bear x-callback-url)

  • 创建便笺 -创建带有可选标题、标签和时间戳的新笔记
  • 在注释中添加文本 -在现有注释中添加、预置或替换文本
  • 抓取URL -从网页内容创建笔记
  • 重命名标签 -重命名现有标记
  • 删除标记 -从Bear中删除标签
  • 垃圾单 -将笔记移至垃圾箱

安装

  1. 克隆存储库:

    git clone https://github.com/davidhollenberger/bear-notes-mcp.git
    cd bear-notes-mcp
    
  2. 创建虚拟环境:

    python3 -m venv bear-mcp-env
    source bear-mcp-env/bin/activate
    
  3. 安装依赖项:

    pip install mcp
    
  4. 获取Bear API代币:

    • 打开熊
    • 去熊→ 偏好设置→ 高级
    • 复制您的API令牌

配置

适用于克劳德桌面

将此配置添加到您的Claude Desktop设置文件中:

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bear-notes": {
      "command": "/path/to/bear-notes-mcp/bear-mcp-env/bin/python",
      "args": ["/path/to/bear-notes-mcp/bear-mcp-server.py"],
      "env": {
        "BEAR_API_TOKEN": "your_bear_api_token_here"
      }
    }
  }
}

克劳德代码

使用 /mcp 添加Bear MCP服务器的命令:

/mcp add bear-notes --env BEAR_API_TOKEN=your_bear_api_token_here -- /path/to/bear-notes-mcp/bear-mcp-env/bin/python /path/to/bear-notes-mcp/bear-mcp-server.py

替换 /path/to/bear-notes-mcp 使用克隆存储库的实际路径,以及 your_bear_api_token_here 使用您的Bear API代币。

需求

  • macOS(Bear仅适用于Mac)
  • Python 3.7+
  • Bear应用程序已安装并正在运行
  • Bear API令牌(用于写入操作)