mcp-server-bear

mcp-server-bear

一个 MCP 服务器，对接 Bear 熊掌记的 API，实现在任意 MCP 客户端以对话形式创建笔记的功能。

功能特点

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

系统要求

• macOS（因为 Bear 应用仅支持 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

MCP 客户端配置

在你喜欢的 MCP 客户端中配置此服务器。以下是一些常见客户端的配置示例：

ChatWise

复制这段代码，打开 ChatWise，选择 从剪切板导入 JSON

{
  "mcpServers": {
    "mcp-server-bear": {
      "command": "npx",
      "args": ["-y", "mcp-server-bear"]
    }
  }
}

<img width="867" alt="image" src="https://github.com/user-attachments/assets/2beaabbf-b5dc-4e93-8f1c-408b10f14974" />

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.jsonn 文件，添加以下配置：

{
  "mcpServers": {
    "mcp-server-bear": {
      "command": "npx",
      "args": ["-y", "mcp-server-bear"]
    }
  }
}

Claude

在 Claude.app 中，前往设置 > MCP 服务器 > 添加 MCP 服务器，然后添加：

• 名称：Bear MCP 服务器
• 命令：npx
• 参数：-y mcp-server-bear

使用示例

在配置好 MCP 客户端后，可以与 AI 对话，请求它记录笔记到 Bear。例如：

1. "帮我记录一下今天的会议笔记"
2. "把这段代码保存到 Bear 笔记中"
3. "总结我们的对话并保存到 Bear 中"
4. "在 Bear 中搜索关于项目计划的笔记"
5. "打开我的最新 Bear 笔记"

AI 会理解你的意图，并使用相应的工具与 Bear 应用交互。

工具说明

此 MCP 服务器提供了以下工具：

1. write_note：将笔记写入 Bear 应用

   • 参数：
     • title：笔记标题（必填）
     • text：笔记内容，支持 Markdown 格式（必填）
     • tags：标签数组（可选）

2. open_note：打开 Bear 中的笔记

   • 参数：
     • title：通过标题打开笔记
     • id：通过ID打开笔记

3. search_notes：搜索 Bear 笔记

   • 参数：
     • term：搜索关键词（必填）
     • tag：筛选特定标签（可选）

开发

# 克隆项目
git clone https://github.com/Ssiswent/mcp-server-bear.git
cd mcp-server-bear

# 安装依赖
npm install

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

# 使用 Inspector 调试工具
npm run inspector

发布

# 登录到 npm
npm login

# 发布到 npm
npm publish --access public

许可

MIT