Bear MCP Server

基本能力

产品定位

Bear MCP Server 是一个用于与 Bear 笔记软件交互的 MCP 服务器，旨在通过 API 调用来扩展 Bear 笔记软件的功能。

核心功能

• 支持多种 Bear 笔记软件的操作，包括但不限于：
• 打开笔记 (/open-note)
• 创建笔记 (/create)
• 管理标签 (/tags, /open-tag)
• 搜索笔记 (/search)
• 抓取 URL (/grab-url)
• 待办事项 (/todo)
• 今日笔记 (/today)

适用场景

• 开发者希望通过 API 自动化 Bear 笔记软件的操作。
• 用户希望通过命令行或桌面应用扩展 Bear 笔记软件的功能。
• 需要集成 Bear 笔记软件到其他工作流中的场景。

工具列表

• Goose CLI：通过配置文件和命令行工具集成 Bear MCP Server。
• Goose Desktop：通过桌面应用配置 Bear MCP Server。
• Claude Desktop：通过配置文件集成 Bear MCP Server。
• Smithery：自动化安装 Bear MCP Server 到 Claude Desktop。

常见问题解答

• 已知问题：每次 API 调用都会打开一个浏览器。

使用教程

使用依赖

• 需要安装 Python 环境。
• 需要 Bear 笔记软件的 API Token。

安装教程

对于 Goose CLI

编辑配置文件 ~/.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 Desktop

添加新扩展，配置如下：

• Type: Standard IO
• ID: bear
• Name: Bear
• Description: Interacting with Bear note-taking software
• Command: uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bear
• Environment Variables: 添加 BEAR_API_TOKEN 并填入你的 API Token

对于 Claude Desktop

编辑 claude_desktop_config.json 文件，在 mcpServers 下添加以下内容：

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

通过 Smithery 安装

运行以下命令：

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

调试方式

安装完成后，重启相关应用（如 Goose Desktop 或 Claude Desktop）以确保配置生效。可以通过调用支持的 API 操作来测试功能是否正常工作。

许可证

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