返回 MCP 目录
public公开dns本地运行

bear-app-mcp

一个基于Python的MCP接口,用于与Bear笔记应用交互,提供笔记列表获取、标签筛选、内容摘要查看和删除功能。

article

README

🚀 熊笔记应用 MCP

熊笔记应用 MCP 是一个基于 Python 的机器控制协议(Machine Control Protocol)接口。它能与美丽且灵活的 Bear 笔记应用程序进行交互,特别适合用于笔记记录和散文创作,为用户提供便捷的操作体验。

🚀 快速开始

在使用熊笔记应用 MCP 前,需要满足以下先决条件:

  1. 安装 Python 3.11。
  2. 安装 UV,使用命令 curl -LsSf https://astral.sh/uv/install.sh | sh
  3. 安装依赖项,使用命令 uv activate && uv install

MCP 服务器配置

在您的 MCP 配置中添加以下内容:

{
  "mcpServers": {
    "Raindrop": {
      "command": "uv",
      "args": [
        "--directory",
        "<项目克隆位置>",
        "run",
        "bear.py"
      ],
      "env": {
      }
    }
  }
}

✨ 主要特性

此 MCP 提供了以下工具来与 Bear 互动:

  1. 获取笔记列表
    • 可获取按更新日期排序的最新笔记。
    • 支持指定要返回的笔记数量。
    • 返回包含其最后更新时间戳的笔记标题。
  2. 通过标签获取笔记
    • 能根据特定标签过滤笔记。
    • 返回所有带有指定标签的笔记,且按更新日期排序。
    • 标签应包含 '#' 前缀(例如:'#工作')。
  3. 获取笔记摘要
    • 通过标题获取特定笔记的内容。
    • 返回笔记内容的前五行。
    • 包含笔记的最后更新时间戳。
  4. 删除笔记
    • 通过标题删除特定笔记。
    • 在 Bear 中将笔记标记为已删除。
    • 返回成功/失败消息。

📄 许可证

本项目采用 MIT 许可证,有关详细信息,请参见 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端