Pushover

🚀 推维信 MCP

这是一个基于 Model Context Protocol 在推维信.net 上的实现，主要用于借助推维信发送通知，让 AI 代理与推维信.net 之间的通知交互更加便捷高效。

🚀 快速开始

此 MCP 允许 AI 代理通过推维信.net 发送通知。它实现了 MCP 规范，使得与兼容的 AI 系统集成变得无缝。

✨ 主要特性

• 实现了 Model Context Protocol，可与兼容的 AI 系统无缝集成。
• 提供 send 工具，可通过推维信发送通知，且支持多种参数配置。

📦 安装指南

使用 Cursor

方法 1：全局安装

使用 npx 运行 MCP 服务器：

npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER

在你的 Cursor IDE 中：

1. 转到 Cursor 设置 > MCP。
2. 点击 + 添加新的 MCP 服务器。
3. 填写表单：
   • 名称：推维信通知（或其他你喜欢的名称）。
   • 类型：命令。
   • 命令：npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER。

方法 2：项目特定配置

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

{
  "servers": {
    "pushover": {
      "command": "npx -y pushover-mcp"
    }
  }
}

使用 Roo Code

1. 打开你的项目并转到 设置 > MCP。
2. 点击 添加新的 MCP 服务器。
3. 填写以下信息：
   • 名称：推维信通知。
   • 类型：命令。
   • 命令：npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER。

💻 使用示例

基础用法

此 MCP 提供一个工具 send，用于通过推维信发送通知。

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

示例 MCP 工具调用

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

使用 Cursor 的详细步骤

1. 打开 Cursor 并转到 设置 > MCP。
2. 点击 添加新的 MCP 服务器。
3. 填写以下信息：
   • 名称：推维信通知。
   • 类型：命令。
   • 命令：npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER。
4. 完成后，你可以通过 MCP 代理 菜单测试此服务器。

示例截图

🔧 技术细节

开发步骤

要开始开发，请执行以下步骤：

1. 安装依赖：

npm install

2. 构建项目：

npm run build

3. 运行测试：

npm test

📄 许可证

本项目采用 MIT 协议。

配置说明

你需要从 推维信.net 控制面板 获取推维信.net 的应用令牌和你的用户密钥。