金大哥 - my-bear-mcp-server MCP 详情

article

README

🚀 熊 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 笔记访问方式。如需更多信息，请参考项目文档或提交问题。

my-bear-mcp-server