B

Bear笔记助手

@jkawamoto/mcp-bear
0 Stars 329 次浏览 jkawamoto 更新于 2026-08-23

便于与Bear笔记软件进行交互,允许用户通过Bear的X-callback-url方案执行打开笔记、创建笔记和搜索笔记等操作。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "youtube-transcript": {
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-bear",
        "mcp-bear",
        "--token",
        "\u003cYOUR_TOKEN\u003e"
      ],
      "command": "uvx"
    }
  }
}

该服务需要配置环境变量:BEAR_API_TOKEN

可用工具 (8 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

open_note 2 个参数

Open a note identified by its title or id and return its content.

该工具无需必填参数,直接调用即可

create 4 个参数

Create a new note and return its unique identifier. Empty notes are not allowed.

该工具无需必填参数,直接调用即可

tags

Return all the tags currently displayed in Bear’s sidebar.

该工具无需必填参数,直接调用即可

open_tag 1 个参数 需填 1 项

Show all the notes which have a selected tag in bear.

必填参数:name

todo 1 个参数

Select the Todo sidebar item.

该工具无需必填参数,直接调用即可

today 1 个参数

Select the Today sidebar item.

该工具无需必填参数,直接调用即可

search 2 个参数

Show search results in Bear for all notes or for a specific tag.

该工具无需必填参数,直接调用即可

grab_url 2 个参数 需填 1 项

Create a new note with the content of a web page and return its unique identifier.

必填参数:url

服务介绍

[!IMPORTANT]
该应用程序目前正处于开发阶段。已知问题:每次API调用都会打开一个浏览器窗口

Bear MCP 服务器

Python 应用程序
GitHub 许可证
pre-commit
Ruff
smithery 徽章

这是一个用于与Bear笔记软件交互的MCP服务器。

安装

Goose CLI

要启用Goose CLI中的Bear扩展,请编辑配置文件~/.config/goose/config.yaml以包含以下条目:

extensions:
  bear:
    name: Bear
    cmd: uvx
    args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]
    envs: { "BEAR_API_TOKEN": "<YOUR_TOKEN>" }
    enabled: true
    type: stdio

Goose 桌面版

添加一个新的扩展,并使用以下设置:

  • 类型:标准IO
  • ID:bear
  • 名称:Bear
  • 描述:与Bear笔记软件进行交互
  • 命令uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bear
  • 环境变量:添加BEAR_API_TOKEN并填入您的API令牌

有关在Goose桌面版中配置MCP服务器的更多详细信息,请参阅文档:
使用扩展 - MCP 服务器

Claude 桌面版

要为Claude桌面版配置此服务器,请编辑claude_desktop_config.json文件,在mcpServers下添加以下条目:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-bear",
        "mcp-bear",
        "--token",
        "<YOUR_TOKEN>"
      ]
    }
  }
}

编辑后,重启应用程序。
更多信息请见:针对Claude桌面版用户 - 模型上下文协议

通过Smithery安装

要通过Smithery自动为Claude桌面版安装Bear MCP服务器:

npx -y @smithery/cli install @jkawamoto/mcp-bear --client claude

实现的操作

该服务器支持以下操作。关于每个操作的详情,请参考Bear的X-callback-url方案文档

  • /open-note
  • /create
  • /add-text
  • /add-file
  • /tags
  • /open-tag
  • /rename-tag
  • /delete-tag
  • /trash
  • /archive
  • /untagged
  • /todo
  • /today
  • /locked
  • /search
  • /grab-url

许可证

本应用程序采用MIT许可证发布。更多详情请参阅LICENSE文件。

相关 MCP 服务