Notify MCP

通知mcp

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

Watch the example

先决条件

• 支持通知的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

1. 添加通知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

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

光标

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

1. 打开光标设置：

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

1. 配置服务器：

- 姓名： 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

1. 通过配置文件：

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

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

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

1. 通过运行验证 “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