Pushover MCP

🚀 推送器 MCP

推送器 MCP 是一个实现 Model Context Protocol 的推送通知服务，可通过 Pushover.net 发送通知，助力 AI 代理实现无缝通知发送。

🚀 快速开始

推送器 MCP 允许 AI 代理通过 Pushover.net 发送通知，它实现了 MCP 规范，能与兼容的 AI 系统无缝集成。

✨ 主要特性

• 实现 Model Context Protocol，可与兼容的 AI 系统无缝集成。
• 提供 send 工具，可通过 Pushover 发送通知，支持多种参数配置。
• 支持在 Cursor IDE 和 Roo Code 中使用，提供不同的安装和配置方式。

📦 安装指南

使用 Cursor IDE

方法 1：全局安装

运行 MCP 服务器使用 npx：

npx -y pushover-mcp@latest start --token 您的令牌 --user 您的用户密钥

在您的 Cursor IDE 中：

1. 进入 Cursor 设置 > MCP。
2. 点击 + 添加新的 MCP 服务器。
3. 填写表单：
   • 名称：Pushover 通知（或其他您喜欢的名称）。
   • 类型：command。
   • 命令：npx -y pushover-mcp@latest start --token 您的令牌 --user 您的用户密钥。

方法 2：项目特定配置

在您的项目中添加一个 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "pushover": {
      "command": "npx",
      "args": [
        "-y",
        "pushover-mcp@latest",
        "start",
        "--token",
        "您的令牌",
        "--user", 
        "您的用户密钥"
      ]
    }
  }
}

使用 Roo Code

此工具也可以通过 Roo Code 使用，提供类似的集成和配置选项。

💻 使用示例

基础用法

配置

您需要：

1. 从 Pushover.net 获取一个应用程序令牌。
2. 获取您的用户密钥。 这些信息来自您的 Pushover.net 仪表盘。

工具模式

MCP 提供了一个工具 send，用于通过 Pushover 发送通知。

{
  message: string;          // 必填：要发送的消息
  title?: string;          // 可选：消息标题
  priority?: number;       // 可选：-2 到 2（-2：最低，2：紧急）
  sound?: string;         // 可选：通知声音
  url?: string;           // 可选：包含的 URL
  url_title?: string;     // 可选：URL 的标题
  device?: string;        // 可选：指定目标设备
}

示例 MCP 工具调用

{
  "name": "send",
  "params": {
    "message": "来自 AI 的问候",
    "title": "AI 通知",
    "priority": 1
  }
}

高级用法

配置完成后，Pushover 通知工具将自动在 Cursor AI 代理中可用。您可以通过以下方式使用：

1. 工具将在 可用工具 下列出。
2. 代理会自动在相关情况下使用它。
3. 您可以明确要求代理发送通知。 默认情况下，代理会在发送通知前询问批准。启用“Yolo 模式”以允许自动发送。

🔧 技术细节

开发

安装依赖

npm install

构建

npm run build

运行测试

npm test

📄 许可证

本项目采用 MIT License 许可证。