使用说明

项目简介

Bear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，它充当 LLM 客户端和 Bear 笔记软件之间的桥梁，允许 LLM 通过调用工具来操作 Bear 笔记。通过这个服务器，LLM 可以访问和操作用户在 Bear 中存储的笔记内容，实现更智能的笔记管理和信息检索。

主要功能点

打开笔记: 根据笔记标题或 ID 打开指定的 Bear 笔记，并返回笔记内容，方便 LLM 获取上下文信息。
创建笔记: 允许 LLM 创建新的 Bear 笔记，可以指定标题、正文和标签，支持添加时间戳，用于快速记录和整理信息。
标签管理: 获取 Bear 应用中所有标签列表，以及打开包含特定标签的笔记列表，帮助 LLM 理解和利用笔记的分类体系。
搜索功能: 支持在 Bear 笔记中进行关键词搜索，包括在 "Todo" 和 "Today" 侧边栏项目中搜索，方便 LLM 查找特定信息。
网页抓取: 通过 URL 抓取网页内容并创建为新的 Bear 笔记，扩展了信息来源。

安装步骤

环境准备: 确保你的系统已安装 Python 环境。
安装方式:
- 通过 'uvx' (推荐): 如果你的 MCP 客户端支持 'uvx' 命令，可以直接使用 'uvx' 从 GitHub 安装并运行 Bear MCP Server。这是最便捷的方式，例如 Claude Desktop 推荐使用此方法。
- 手动安装: 你也可以将仓库克隆到本地，然后根据需要进行配置和手动运行。

服务器配置

为了让 MCP 客户端（例如 Claude Desktop 或 Goose）连接到 Bear MCP Server，你需要配置客户端的 MCP 服务器设置。以下是针对不同客户端的配置示例：

1. Claude Desktop 配置 (JSON 格式):

{
  "mcpServers": {
    "bear": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-bear",
        "mcp-bear",
        "--token",
        "<YOUR_BEAR_API_TOKEN>"  //  请替换为你的 Bear API Token
      ]
    }
  }
}

参数说明:

'command': 设置为 'uvx'，表示使用 'uvx' 工具运行。
'args': 参数列表，包括：
- '--from git+https://github.com/jkawamoto/mcp-bear': 指定从 GitHub 仓库安装。
- 'mcp-bear': 指定要安装和运行的包名。
- '--token <YOUR_BEAR_API_TOKEN>': 必须替换为你的 Bear API Token。请在 Bear 应用的偏好设置中获取 API Token。

2. Goose CLI 配置 (YAML 格式):

extensions:
  bear:
    name: Bear
    cmd: uvx
    args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]
    envs: { "BEAR_API_TOKEN": "<YOUR_TOKEN>" }  #  请替换为你的 Bear API Token
    enabled: true
    type: stdio

参数说明:

'cmd': 设置为 'uvx'。
'args': 参数列表，与 Claude Desktop 类似。
'envs': 环境变量设置，'BEAR_API_TOKEN' 必须替换为你的 Bear API Token。

3. 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'，并将其值设置为你的 Bear API Token。

重要提示: 请务必将 '<YOUR_BEAR_API_TOKEN>' 替换为你从 Bear 应用中获取的 API Token。API Token 的获取方式请参考 Bear 官方文档。

基本使用方法

确保 Bear 应用已安装并运行。
根据你的 MCP 客户端类型 (Claude Desktop, Goose 等)，按照上述 "服务器配置" 部分的说明配置 Bear MCP Server。
在 MCP 客户端中启用 Bear MCP Server 扩展或服务器连接。
现在，你可以通过 MCP 客户端，使用自然语言指令或相应的界面操作来调用 Bear MCP Server 提供的工具，例如让 LLM 帮你打开、创建或搜索 Bear 笔记。

例如，在 Claude Desktop 中，你可以尝试以下指令：

"打开标题为 '会议记录' 的笔记"
"创建一个名为 '购物清单' 的笔记，内容是 '牛奶，鸡蛋，面包'"
"搜索包含 '项目进展' 的笔记"

LLM 客户端会将这些指令转换为对 Bear MCP Server 工具的调用，从而实现与 Bear 笔记软件的交互。

关键词