Notify Mcp

notify-mcp

一个基于 Bash 的轻量级 Model Context Protocol（MCP）服务，可通过 notify-send 发送桌面通知。此零依赖服务可让 Claude、Cursor 和 VS Code 等 AI 助手直接向你的 Linux 桌面和 MacOS 发送系统通知。

先决条件

• 支持通知的 Linux 系统或 MacOS
• 用于 Linux 的 notify-send 命令（通常由 libnotify 软件包提供）
• jq 工具

安装 notify-send

如果系统尚未安装 notify-send：

Ubuntu/Debian：

sudo apt-get install libnotify-bin

Fedora/RHEL：

sudo dnf install libnotify

Arch Linux：

sudo pacman -S libnotify

Alt Linux：

sudo apt-get install notify-send

安装

1. 克隆仓库：

git clone https://github.com/longdog/notify-mcp.git
cd notify-mcp

2. 使脚本可执行：

chmod +x notify-mcp.sh

3. （可选）将其添加到 PATH，以便更轻松地访问：

sudo ln -s $(pwd)/notify-mcp.sh /usr/local/bin/notify-mcp

配置

Claude Desktop

Claude Desktop 使用 JSON 配置文件来定义 MCP 服务。

1. 打开 Claude Desktop 设置：

   • 点击 Claude 菜单 → Settings → Developer 选项卡
   • 点击 Edit Config，打开 claude_desktop_config.json

2. 添加 notify-mcp 服务配置：

{
  "mcpServers": {
    "notify": {
      "command": "/absolute/path/to/notify-mcp.sh",
      "args": []
    }
  }
}

完整路径示例：

{
  "mcpServers": {
    "notify": {
      "command": "/home/username/notify-mcp/notify-mcp.sh",
      "args": []
    }
  }
}

3. 保存文件并重启 Claude Desktop

4. 查看 Claude Desktop 界面中的 MCP 服务指示器（🔌 图标），确认连接成功

Cursor

Cursor IDE 支持通过设置配置 MCP 服务。

1. 打开 Cursor 设置：

   • 按 Ctrl+Shift+P（Linux/Windows）或 Cmd+Shift+P（macOS）
   • 搜索 "MCP: Add MCP Server"
   • 选择 Command (stdio)

2. 配置服务：

   • 名称： notify
   • 命令： /absolute/path/to/notify-mcp.sh
   • 参数：（留空）

替代方案：手动配置

编辑 Cursor 设置文件（工作区中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "notify": {
      "command": "/home/username/notify-mcp/notify-mcp.sh",
      "args": []
    }
  }
}

3. 重启 Cursor 以应用更改

VS Code

VS Code 通过 GitHub Copilot 扩展支持 MCP 服务。

1. 通过命令面板：

   • 按 Ctrl+Shift+P（Linux/Windows）或 Cmd+Shift+P（macOS）
   • 运行 "MCP: Add Server"
   • 选择 Command (stdio)
   • 输入服务信息：
     • 名称： notify
     • 命令： /absolute/path/to/notify-mcp.sh

2. 通过配置文件：

   将以下内容添加到用户设置（.vscode/mcp.json）或工作区设置中：

{
  "servers": {
    "notify": {
      "command": "/home/username/notify-mcp/notify-mcp.sh",
      "args": []
    }
  }
}

3. 重启 VS Code 以加载 MCP 服务

4. 在命令面板中运行 "MCP: List Servers" 进行验证

Gemini CLI

Gemini CLI 通过其设置配置文件支持 MCP 服务。

1. 找到 Gemini CLI 设置文件：

~/.gemini/settings.json

2. 将 notify-mcp 服务添加到 mcpServers 部分：

{
  "mcpServers": {
    "notify": {
      "command": "/home/username/notify-mcp/notify-mcp.sh",
      "args": []
    }
  }
}

完整示例：

{
  "apiKey": "your-api-key",
  "mcpServers": {
    "notify": {
      "command": "/home/username/notify-mcp/notify-mcp.sh",
      "args": []
    }
  },
  "mcp": {
    "allowed": ["notify"]
  }
}

3. 重启 Gemini CLI 或启动新会话：

gemini-cli

4. 验证服务已加载：

/mcp

此命令会列出所有已连接的 MCP 服务，包括 notify。

替代方案：直接使用 STDIO 传输

如需测试或用于高级场景，你可以通过 stdio 直接与 MCP 服务交互：

echo '{"jsonrpc":"2.0","id":"2","method":"tools/call","params": {"arguments":{"title":"Hello","message":"World"}}}' | ./notify-mcp.sh