notify-mcp

🚀 notify - mcp

notify - mcp 是一个轻量级的、基于Bash的模型上下文协议（MCP）服务器，它借助 notify - send 实现桌面通知功能。这个零依赖的服务器允许Claude、Cursor和VS Code等AI助手直接向你的Linux桌面发送系统通知。

🚀 快速开始

前提条件

• 支持通知功能的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. （可选）将其添加到系统路径以便更方便地访问：

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

📚 详细文档

Claude Desktop

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

1. 打开Claude Desktop设置：
   • 点击 Claude 菜单 → 设置 → 开发者 标签
   • 点击 编辑配置 以打开 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": []
    }
  }
}

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

gemini-cli

4. 验证服务器是否已加载：

/mcp

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

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

对于测试或高级用例，你可以通过标准输入输出（stdio）直接与MCP服务器进行交互：

'{"jsonrpc":"2.0","id":"2","method":"show","title":"Hello","message":"World"}' | ./notify-mcp.sh