Bear MCP Server 使用说明

项目简介

Bear MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，它允许支持 MCP 协议的大型语言模型客户端（如 Claude）访问您本地 macOS 上的 Bear Notes 笔记应用中的内容。通过此服务器，您可以让 LLM 理解和利用您在 Bear Notes 中存储的笔记信息，例如检索特定笔记、获取标签列表等。

主要功能点

读取笔记内容: 允许 LLM 获取 Bear Notes 中存储的笔记文本。
根据关键词搜索笔记: 支持 LLM 根据指定的关键词搜索相关的笔记。
列出所有标签: 提供 Bear Notes 中所有标签的列表，方便 LLM 理解笔记的组织结构。

安装步骤

克隆仓库: 在您的终端中执行以下命令，将 Bear MCP Server 仓库克隆到本地：

git clone https://github.com/akseyh/bear-mcp-server

进入项目目录: 克隆完成后，进入 'bear-mcp-server' 目录：
```
cd bear-mcp-server
```
安装依赖: 使用 npm 安装项目所需的依赖包：
```
npm install
```
构建项目: 构建 TypeScript 代码为 JavaScript 代码：
```
npm run build
```

服务器配置

要将 Bear MCP Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 'claude_desktop_config.json' 文件。在 'mcpServers' 字段中添加如下配置，以 'bear' 作为服务器名称：

{
  "mcpServers": {
    "bear": {
      "command": "node",
      "args": ["/path/to/bear-mcp-server/build/index.js"] // 将 "/path/to/bear-mcp-server" 替换为实际的项目本地路径
    }
  }
}

注意: 请将 'args' 字段中的 '/path/to/bear-mcp-server' 替换为您本地 'bear-mcp-server' 项目的绝对路径。例如，如果您的项目位于用户目录下的 'Documents/bear-mcp-server'，则应替换为 '/Users/your_username/Documents/bear-mcp-server/build/index.js'。

基本使用方法

启动服务器: 当 MCP 客户端尝试连接名为 'bear' 的 MCP 服务器时，客户端会根据您在 'claude_desktop_config.json' 中配置的 'command' 和 'args' 启动 Bear MCP Server。
LLM 调用工具: 在支持 MCP 协议的 LLM 应用中，您可以使用以下工具来访问 Bear Notes 数据：
- 'get_notes': 获取所有笔记内容。
- 'get_tags': 获取所有笔记标签。
- 'get_notes_like': 根据关键词搜索相关笔记。
例如，您可以指示 LLM 调用 'get_notes_like' 工具并提供关键词，以检索包含特定主题的笔记。

前提条件:

确保您的 macOS 系统上已安装 Bear Notes 应用程序，并且您已经存储了笔记数据。
确保您的 MCP 客户端（如 Claude Desktop）已正确配置并能加载 'claude_desktop_config.json' 文件。

关键词