Bear应用程序MCP服务器
一个模型上下文协议（MCP）服务器，为Claude提供对Bear App笔记的访问。直接从Claude Desktop或任何兼容MCP的客户端搜索、检索和分析您的Bear笔记。
特性
🔍 搜索与发现
- 全文搜索 在你所有的笔记中
- 基于标签的过滤 对于有组织的内容
- 基于标题的搜索 精确或部分匹配
- 最近的笔记 按修改日期筛选
💻 代码和技术内容
- Kubernetes清单查找器 -查找部署示例、服务配置等。
- 代码示例搜索 -按编程语言查找代码片段
- 代码块提取 -自动解析和分类代码块
- 技术文件 发现
📊 内容分析
- 字数统计 内容统计
- 代码语言检测 来自围栏代码块
- 内容预览 用于快速扫描
- 元数据抽取 （创建/修改日期）
安装
先决条件
- macOS（Bear应用程序仅适用于macOS/iOS）
- 已安装Bear应用程序，并附有一些注释
- Python 3.8或更高版本
- Claude Desktop（用于桌面集成）
设置步骤
- 克隆或下载服务器脚本
git clone github.com/netologist/mcp-bear-notes- 创建虚拟环境
uv install
source .venv/bin/activate- 测试服务器
uv run python main.pyClaude桌面集成
配置文件位置
编辑您的Claude Desktop配置文件：
~/Library/Application Support/Claude/claude_desktop_config.json添加MCP服务器配置
{
"mcpServers": {
"bear-notes": {
"command": "/full/path/to/mcp-bear-notes/.venv/bin/python",
"args": ["/full/path/to/mcp-bear-notes/main.py"],
"env": {
"PYTHONPATH": "/full/path/to/mcp-bear-notes/.venv/lib/python3.13/site-packages"
}
}
}
}重要：替换 /full/path/to/ 使用您的实际文件路径。
重新启动克劳德桌面
关闭并重新打开Claude Desktop以加载MCP服务器。
使用示例
一旦与Claude Desktop集成，您就可以使用自然语言与Bear笔记进行交互：
基本搜索
"Search my Bear notes for Docker examples"
"Find notes about Python APIs"
"Show me my recent notes from this week"技术内容
"Find my Kubernetes deployment manifests"
"Look for JavaScript code examples in my notes"
"Show me notes with YAML configurations"特定检索
"Get the note titled 'Development Setup'"
"Find notes tagged with 'work'"
"Show me all my available tags"可用工具
search_bear_notes(query, tag, limit)
按内容和标签搜索笔记。
query：要搜索的文本tag：按特定标签筛选（不带#）limit：最大结果（默认值：20）
get_bear_note(note_id)
通过其唯一ID检索特定笔记。
note_id：钞票的唯一标识符
find_kubernetes_examples(resource_type)
查找与Kubernetes相关的内容。
resource_type：K8s资源（部署、服务等）
find_code_examples(language, topic, limit)
搜索代码示例。
language：编程语言topic：代码主题/域limit：最大结果（默认值：15）
find_notes_by_title(title_query, exact_match)
按标题搜索笔记。
title_query：要搜索的标题文本exact_match：完全或部分匹配
get_recent_notes(days, limit)
获取最近修改的笔记。
days：回顾多少天（默认值：7）limit：最大结果（默认值：20）
list_bear_tags()
列出笔记中找到的所有标签。
Bear数据库信息
服务器从Bear的SQLite数据库读取数据，该数据库位于：
~/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/database.sqlite数据库访问说明
- 只读访问 -服务器从不修改您的笔记
- 不要求进行验证 -使用直接SQLite访问
- 演出 -数据库查询已针对速度进行了优化
- 安全 -仅访问未被丢弃的笔记
故障排除
常见问题
服务器无法启动
- 检查配置中的Python路径
- 验证虚拟环境激活
- 确保安装了fastmcp
未找到笔记
- 验证Bear数据库路径是否存在
- 检查Bear应用程序是否已打开至少一次
- 确认笔记不在垃圾桶中
Claude Desktop集成失败
- 验证配置文件中的JSON语法
- 检查文件路径是否为绝对路径，而非相对路径
- 配置更改后重新启动Claude Desktop
权限被拒绝错误
- 确保脚本具有执行权限：
chmod +x main.py - 检查Bear数据库文件权限
调试模式
直接运行服务器以查看调试输出：
python main.py日志文件
检查Claude Desktop日志中的MCP服务器错误：
~/Library/Logs/Claude/安全与隐私
- 仅限本地：所有数据都保留在您的机器上
- 只读：服务器从不修改您的笔记
- 无网络：不需要外部连接
- 开源：业务完全透明
贡献
欢迎投稿！需要改进的地方：
- 其他搜索筛选器
- 导出功能
- 笔记创建功能
- iOS快捷方式集成
- 性能优化
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
更新日志
v1.0.0
- 初始版本
- 基本搜索和检索功能
- Kubernetes和代码示例查找器
- Claude桌面集成
- 标签列表和过滤
支持
对于问题和疑问：
- 检查故障排除部分
- 查看Claude Desktop MCP文档
- 在GitHub上打开一个问题
- 查看Bear App论坛，了解与数据库相关的问题
______________________________________________________________________
备注：这是一个非官方工具，与Bear App或Anthropic无关。请自行决定使用。