Bear MCP服务器
将Bear notes与Claude Code集成在一起的MCP服务器。
建筑
此服务器使用混合方法以获得最佳性能和安全性：
| 操作 | 方法 | 为什么 |
|---|---|---|
| 读取（搜索、获取、列表） | SQLite | 快速、可靠、无需UI交互 |
| 写入（创建、附加、预置、垃圾、重命名标签、删除标签） | URL方案 | Safe，使用Bear的官方API |
需求
安装
cd bear-notes-mpc-server
bun installClaude代码配置
使用Claude Code CLI添加MCP服务器：
claude mcp add --transport stdio --scope user bear -- bun run /absolute/path/to/bear-mcp-server/src/server.ts注： 将路径替换为您的实际绝对路径 bear-mcp-server 目录。范围选项：
--scope user-在所有Claude Code会话中可用（推荐）--scope local-仅在当前项目目录中可用--scope project-创建.mcp.json通过git进行团队共享
检查已配置的服务器：
claude mcp list查看服务器详细信息：
claude mcp get bear以Bear整合开始Claude
配置完MCP服务器后，只需启动一个新的Claude会话：
claudeClaude将自动启动Bear MCP服务器，您将可以访问所有Bear工具。
卸下MCP服务器
MCP服务器作为Claude Code的子进程运行，并在您退出Claude时自动停止。
要永久删除服务器，请执行以下操作：
claude mcp remove bear可用工具
| 工具 | 说明 |
|---|---|
bear_create_note | 使用可选标签创建新笔记 |
bear_search | 按文本或标签搜索笔记 |
bear_get_note | 按ID获取笔记的完整内容 |
bear_append | 将文本附加到现有注释中 |
bear_prepend | 将文本放在现有注释的开头 |
bear_replace_content | 替换现有注释的全部内容 |
bear_list_tags | 列出所有带有注释计数的标签 |
bear_list_by_tag | 列出带有特定标签的所有笔记 |
bear_rename_tag | 重命名现有标记 |
bear_delete_tag | 从所有笔记中删除现有标记 |
bear_trash_note | 将便条移至垃圾箱 |
bear_archive_note | 存档笔记 |
bear_unarchive_note | 恢复已存档的笔记 |
bear_list_archived | 列出所有已存档的笔记 |
Claude中的示例用法
服务器运行后，您可以向Claude询问以下问题：
- “在我的Bear笔记中搜索‘项目创意’”
- “在Bear中列出我的所有标签”
- “创建一个标题为“会议笔记”的新笔记，其中包含今天的日期”
- “显示所有标记为“工作”的笔记”
- “将此摘要添加到我的“每日日志”注释中”
- “将我的‘旧项目’标记重命名为‘已存档项目’”
- “从所有笔记中删除'temp'标签”
数据库位置
服务器会自动在以下位置之一找到Bear的数据库：
- Icloud同步：
~/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/database.sqlite - 本地存储：
~/Library/Containers/net.shinyfrog.bear/Data/Documents/Application Data/database.sqlite
日志
日志被写入stderr，Claude Code会自动捕获。
要启用调试日志记录，请添加服务器 --env 标志：
claude mcp add --transport stdio --scope user --env BEAR_MCP_LOG_LEVEL=debug bear -- bun run /absolute/path/to/bear-mcp-server/src/server.ts日志级别： debug, info （默认）， warn, error
权限
首次运行时，macOS可能会要求自动权限，以允许服务器打开Bear URL。
故障排除
“未找到Bear数据库”
- 确保Bear已安装并至少打开过一次
创建后未出现注释
- Bear可能需要一点时间来同步。注释是通过URL方案创建的，可能不会立即出现在SQLite查询中。
数据库权限被拒绝
- 数据库以只读模式打开。如果仍然出现错误，请检查Bear当前是否没有写入数据库。
MCP服务器未连接
- 验证配置中的路径是否正确
- 跑
claude mcp list检查服务器是否已配置 - 确保Bun已安装并在PATH中可用