mcp-server-bear

by Ssiswent

222 downloads
Not rated
GitHub

About

mcp-server-bear is an MCP server that integrates with the Bear note‑taking app on macOS, allowing users to create, open, and search notes through conversational interactions in any MCP client (e.g., Cursor AI, Claude, OpenAI). It is designed for Bear users who want to leverage…

Details

Author
Ssiswent
Downloads
222
Categories
Other

- Create Bear notes via conversational AI.
- Open existing notes by title or ID.
- Search notes by keyword and optional tag.
- Supports Markdown formatting in note content.
- Allows adding tags to notes.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name mcp-server-bear
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the server using npx mcp-server-bear (recommended) or via npm install -g mcp-server-bear. Then configure it in your MCP client (e.g., ChatWise, Windsurf, Claude) using the provided JSON configuration. Once configured, you can ask the AI to write, open, or search Bear notes by simply describing what you need.

write_note

Write a note to Bear

open_note

Open a note in Bear

search_notes

Search for notes in Bear

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

{
    "mcp-server-bear": {
        "command": "npx",
        "args": [
            "-y",
            "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"]
    }
  }
}

image

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:筛选特定标签(可选)

开发

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.