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