AI导哈

桌面通知服务

一个基于Bash的轻量级Model Context Protocol (MCP)服务器，用于通过notify-send发送桌面通知，适用于Linux和MacOS系统。

  • by longdog
  • Shell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 longdog/notify-mcp

使用说明

通知mcp

一个基于Bash的轻量级模型上下文协议（MCP）服务器，用于通过以下方式发送桌面通知 notify-send这个零依赖服务器使Claude、Cursor和VS Code等AI助手能够直接向您的Linux桌面和MacOS发送系统通知。

先决条件

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

安装通知发送

如果 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
  1. 使脚本可执行：
chmod +x notify-mcp.sh
  1. （可选）添加到PATH以便于访问：
sudo ln -s $(pwd)/notify-mcp.sh /usr/local/bin/notify-mcp

配置

克劳德桌面版

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

  1. 打开克劳德桌面设置：

    • 点击 克劳德 menu → 设置 → 开发者 标签
    • 点击 编辑配置 打开 claude_desktop_config.json

  2. 添加通知mcp服务器配置：

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

完整路径示例：

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

  1. 保存文件并重新启动Claude Desktop

  2. 通过查找MCP服务器指示器来验证连接(🔌 图标）在克劳德桌面界面中

光标

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

  1. 打开光标设置：

    • 按 Ctrl+Shift+P （Linux/Windows）或 Cmd+Shift+P （macOS）
    • 搜索 “MCP：添加MCP服务器”
    • 选择 命令（stdio）

  2. 配置服务器：

    • 姓名： notify
    • 命令： /absolute/path/to/notify-mcp.sh
    • 论据： （留空）

替代方案：手动配置

编辑光标设置文件(.cursor/mcp.json 在您的工作空间中）：

{
  "mcpServers": {
    "notify": {
      "command": "/home/username/notify-mcp/notify-mcp.sh",
      "args": []
    }
  }
}
  1. 重新启动Cursor以应用更改

VS Code

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

  1. 通过命令面板：

    • 按 Ctrl+Shift+P （Linux/Windows）或 Cmd+Shift+P （macOS）
    • 跑 “MCP:添加服务器”
    • 选择 命令（stdio）
    • 输入服务器信息：
      • 姓名： notify
      • 命令： /absolute/path/to/notify-mcp.sh

  2. 通过配置文件：

    添加到您的用户设置(.vscode/mcp.json)或工作区设置：

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

  1. 重新启动VS Code以加载MCP服务器

  2. 通过运行验证 “MCP:列出服务器” 从命令选项板

Gemini CLI

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

  1. 找到您的Gemini CLI设置文件：
~/.gemini/settings.json
  1. 将通知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"]
  }
}
  1. 重新启动Gemini CLI或启动新会话：
gemini-cli
  1. 验证服务器是否已加载：
/mcp

这将列出所有连接的MCP服务器，包括 notify.

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

对于测试或高级用例，您可以直接通过stdio与MCP服务器交互：

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

相关 MCP