# Bear MCP Server

这是一个为 Bear 笔记应用设计的 MCP (Model Context Protocol) 服务器，让你能够通过 Claude Code 直接操作 Bear 中的笔记。

## 功能特性

- ✅ 创建新笔记
- ✅ 搜索笔记
- ✅ 添加文本到现有笔记
- ✅ 删除笔记
- ✅ 打开指定笔记
- ✅ 获取所有标签
- ✅ 获取所有笔记（支持分页）

## 安装和使用

### 快速安装（推荐）

使用自动设置脚本：

```bash
./setup.sh
```

脚本会自动完成：
- 依赖安装
- 项目构建
- 生成配置信息

### 手动安装

#### 1. 安装依赖

```bash
npm install
```

#### 2. 构建项目

```bash
npm run build
```

或者使用构建脚本：

```bash
./build.sh
```

#### 3. 配置 MCP 服务器

在 Claude Code 的配置文件中添加以下配置：

```json
{
  "mcpServers": {
    "bear": {
      "command": "node",
      "args": ["/path/to/bear-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}
```

或者复制 `mcp-config.json` 文件的内容到你的 Claude 配置中。

### 4. 重启 Claude Code

配置完成后，重启 Claude Code 以加载新的 MCP 服务器。

## 可用工具

### create_note
创建一个新的 Bear 笔记。

参数：
- `title` (可选): 笔记标题
- `text` (可选): 笔记内容
- `tags` (可选): 标签数组
- `filename` (可选): 自定义文件名
- `pin` (可选): 是否固定笔记
- `open_note` (可选): 创建后是否打开笔记

示例：
```json
{
  "title": "我的新笔记",
  "text": "这是笔记内容",
  "tags": ["标签1", "标签2"],
  "pin": true
}
```

### search_notes
搜索 Bear 中的笔记。

参数：
- `term` (必需): 搜索词
- `token` (可选): 分页令牌

示例：
```json
{
  "term": "项目"
}
```

### add_text
向现有笔记添加文本。

参数：
- `id` 或 `title` (必需其一): 笔记 ID 或标题
- `text` (必需): 要添加的文本
- `mode` (可选): `prepend` 或 `append`，添加方式

示例：
```json
{
  "title": "我的笔记",
  "text": "新添加的内容",
  "mode": "append"
}
```

### delete_note
删除笔记。

参数：
- `id` 或 `title` (必需其一): 笔记 ID 或标题

示例：
```json
{
  "title": "要删除的笔记"
}
```

### open_note
在 Bear 中打开指定笔记。

参数：
- `id` 或 `title` (必需其一): 笔记 ID 或标题
- `new_window` (可选): 是否在新窗口中打开

示例：
```json
{
  "title": "我的笔记",
  "new_window": true
}
```

### get_tags
获取 Bear 中所有标签。

参数：无

### get_all_notes
获取所有笔记列表。

参数：
- `token` (可选): 分页令牌

## 系统要求

- macOS (Bear 目前仅支持 macOS)
- Node.js 18+
- Bear 应用已安装

## 开发

### 开发模式运行

```bash
npm run dev
```

### 构建生产版本

```bash
npm run build
```

## Bear x-callback-url 支持

此 MCP 服务器基于 Bear 的 x-callback-url scheme 实现，支持以下 URL 操作：

- `bear://x-callback-url/create`
- `bear://x-callback-url/add-text`
- `bear://x-callback-url/delete`
- `bear://x-callback-url/open`
- `bear://x-callback-url/search`
- `bear://x-callback-url/tags`

更多关于 Bear x-callback-url 的信息，请参考：[Bear 文档](https://bear.app/faq/x-callback-url-scheme-documentation/)

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！

## 注意事项

1. 确保 Bear 应用已安装并运行
2. 某些操作可能需要 Bear 应用在前台
3. 批量操作时请注意性能，避免一次性操作过多笔记