🚀 熊 MCP 服务器
熊 MCP 服务器是一个模型上下文协议（MCP）服务器，允许像克莱奥这样的 AI 助手从 Bear 笔记应用程序中读取笔记。它直接连接到 Bear 的 SQLite 数据库，并以只读模式运行，充分保障您的笔记安全，不会对其进行任何修改。
🚀 快速开始
选项 1：从 GitHub 安装（推荐）
npx github:bart6114/my-bear-mcp-server
完成上述操作后，服务器将启动并自动连接到您的 Bear 数据库。
选项 2：克隆并在本地运行
# 克隆仓库
git clone https://github.com/bart6114/my-bear-mcp-server.git
cd my-bear-mcp-server
# 安装依赖项
npm install
# 构建并启动
npm run build
npm start
✨ 主要特性
- 以只读模式运行，确保 Bear 笔记数据的安全性，不会对其进行修改。
- 支持克莱奥等 AI 助手从 Bear 笔记应用程序中读取笔记。
- 提供多种只读工具，方便对笔记进行操作。
📦 安装指南
先决条件
- 需在 macOS 系统上安装 Bear 应用程序。
- 需安装 Node.js 18 或更高版本。
配置
对于克莱奥桌面应用程序
将以下内容添加到配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json 中：
{
"mcpServers": {
"bear": {
"command": "npx",
"args": ["github:bart6114/my-bear-mcp-server"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
对于克莱奥 VS Code 扩展
将以下内容添加到配置文件 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 中：
{
"mcpServers": {
"bear": {
"command": "npx",
"args": ["github:bart6114/my-bear-mcp-server"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
💻 使用示例
可用工具
Bear MCP 服务器提供以下只读工具（所有操作均为非破坏性，不会修改您的 Bear 数据库）：
- open_note：通过标题或 ID 打开一个笔记。
- search_notes：按术语或关键字搜索笔记。
- get_folder_notes：获取指定文件夹中的所有笔记。
- list_folders：列出所有可用的文件夹。
🔧 技术细节
服务器采用只读连接的方式访问 Bear 的 SQLite 数据库，以此确保数据的安全性和完整性。以下是实现的关键代码示例：
// 只读数据库连接
const db = new Database('file:/path/to/database.bear?mode=ro');
// 获取所有笔记
async function getAllNotes() {
const result = await db.query(
'SELECT * FROM notes'
);
return result;
}
📚 详细文档
安装位置
若 Bear 数据库位于非标准路径，可通过以下命令指定：
npm start -- --db-path "/path/to/database.bear"
📄 许可证
本项目采用 MIT License。
👥 贡献者
- bart6114 - 项目作者
- contributor-name - 其他贡献者
此服务器旨在为 AI 助手提供安全、高效的 Bear 笔记访问方式。如需更多信息，请参考项目文档或提交问题。