mcp-server-bear

mcp-server-bear

site icon
2025.04.03 0
JavaScript笔记管理Markdown支持API集成交流协作
mcp-server-bear 是一个 MCP 服务器,专门用于对接 Bear 熊掌记的 API,实现在任意 MCP 客户端以对话形式创建、打开和搜索笔记的功能。它支持 Markdown 格式的笔记内容,并允许添加标签。
View on GitHub

Overview

基本能力

产品定位

mcp-server-bear 是一个专门用于与 Bear 熊掌记应用集成的 MCP 服务器,旨在通过 MCP 客户端以对话方式管理笔记。

核心功能

  • 通过 MCP 客户端(如 Cursor AI、Claude、OpenAI 等)以对话方式创建 Bear 笔记
  • 支持打开和搜索现有笔记
  • 支持 Markdown 格式的笔记内容
  • 支持添加标签

适用场景

  • 在会议或学习时快速记录笔记
  • 保存代码片段或其他技术内容
  • 总结对话或会议内容并保存
  • 搜索和打开已有的笔记

工具列表

  1. write_note:将笔记写入 Bear 应用
  2. 参数:title(笔记标题)、text(笔记内容,支持 Markdown)、tags(标签数组,可选)
  3. open_note:打开 Bear 中的笔记
  4. 参数:title(通过标题打开笔记)或 id(通过ID打开笔记)
  5. search_notes:搜索 Bear 笔记
  6. 参数:term(搜索关键词)、tag(筛选特定标签,可选)

常见问题解答

  • 系统要求:macOS(因为 Bear 应用仅支持 macOS 系统)、安装了 Bear 应用、Node.js 14.0.0 或更高版本

使用教程

使用依赖

  • macOS 系统
  • 已安装 Bear 应用
  • Node.js 14.0.0 或更高版本

安装教程

方法 1:使用 npx(推荐)

npx mcp-server-bear

方法 2:全局安装

npm install -g mcp-server-bear
mcp-server-bear

方法 3:从源码安装

git clone https://github.com/Ssiswent/mcp-server-bear.git
cd mcp-server-bear
npm install
npm run build
node build/index.js

调试方式

# 开发模式(监视文件变化并自动编译)
npm run watch

# 使用 Inspector 调试工具
npm run inspector

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。