Bear MCP服务器
一个模型上下文协议（MCP）服务器，允许像克劳德这样的人工智能助手从 熊 笔记应用程序。此实现以只读模式直接连接到Bear SQLite数据库，确保您的笔记保持安全且未被修改。
    
快速开始
选项1：从GitHub安装（推荐）
npx github:bart6114/my-bear-mcp-server就是这样！服务器将开始运行并连接到您的Bear数据库。
选项2：克隆并在本地运行
# Clone the repository
git clone https://github.com/bart6114/my-bear-mcp-server.git
cd my-bear-mcp-server
# Install dependencies
npm install
# Build and run
npm run build
npm start先决条件
- 安装了Bear应用程序的macOS
- Node.js 18或更高版本
配置
适用于Claude桌面应用程序
将其添加到您的配置文件中 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bear": {
"command": "npx",
"args": ["github:bart6114/my-bear-mcp-server"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}对于Claude VS代码扩展
将其添加到您的配置文件中 ~/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
按术语或标签搜索笔记。
获取标签
获取Bear中的所有标签。
open_tag
显示带有特定标签的所有笔记。
示例用法
以下是如何通过AI助手与Bear MCP工具交互的示例：
搜索笔记
让你的人工智能助手搜索包含特定术语的笔记：
Can you find all my notes about "project management"?打开特定注释
让你的AI助手按标题检索特定的笔记：
Show me my note titled "Meeting Notes - March 2025"查看标签
让你的AI助手列出你所有的Bear标签：
What tags do I have in my Bear notes?查找带有特定标签的笔记
让你的AI助手显示带有特定标签的笔记：
Show me all notes with the #work tag高级选项
如果您的Bear数据库位于非标准位置：
npx github:bart6114/my-bear-mcp-server --db-path /path/to/your/database.sqlite技术细节
只读实现
此MCP服务器使用严格的只读连接连接到您的Bear SQLite数据库。这在数据库驱动程序级别强制执行：
// From src/bear-db.ts
this.db = new Database(dbPath, { readonly: true });这确保了：
- 无法对数据库执行任何写入操作
- 您的笔记和标签不能被修改、删除或损坏
- 如果尝试写入权限，数据库连接将失败
此服务器执行的所有操作都是SELECT查询，只检索数据而不修改数据。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。