Pushpad MCP

Pushpad MCP 服务器，用于发送 Web 推送通知并通过 Pushpad API 管理 Pushpad 上的资源（对通知、订阅、项目和发送者执行 CRUD 操作）。

该项目是基于 Pushpad API 构建的薄层，使用了官方的 Pushpad OpenAPI 规范 和 FastMCP for TypeScript。

安全

使用 MCP 技术与您的 Pushpad 账户交互可能存在风险。

此 MCP 服务器提供对 Pushpad API 的完全访问权限，包括不可逆和破坏性操作（如更新、删除等）。API 还可能返回敏感数据，如推送订阅密钥（订阅 API）和 VAPID 密钥（发送者 API）。

我们建议在您的代理中使用适当的 权限模式，并使用具有 受限访问权限 的 Pushpad 令牌。

您可以在代理设置中将权限模式更改为 手动，或为此 MCP 服务器提供的不同工具设置 允许 / 拒绝 权限。

我们建议将存储在发送者中的 VAPID 密钥 排除在 AI 上下文之外：您可以使用具有受限访问权限的 Pushpad 令牌，或拒绝提供对发送者 API 访问权限的工具。

请记住 保持访问令牌私密，切勿将其存储在 Git 仓库中。

Related MCP server: Dialpad Universal MCP Server

安装

步骤 1：将 API 令牌设置为环境变量

首先，您需要 创建一个新的 Pushpad 令牌：打开 Pushpad 仪表板，点击您的账户名称，然后点击 访问令牌 并创建一个新令牌。

然后您需要 将 Pushpad 令牌存储为环境变量。您可以在机器上全局设置（~/.bashrc、~/.zshrc 或其他 shell 配置文件），使用密码管理器（如 1Password CLI），在项目特定的 .env 文件中设置，或直接添加到 MCP 客户端配置文件（如 .mcp.json）。请记得将 .env、.mcp.json 或其他可能包含机密信息的文件添加到 .gitignore 中。

步骤 2：将 MCP 服务器添加到您的 AI 代理

本地 MCP 服务器由您的 MCP 客户端根据 MCP JSON 配置文件中定义的设置直接启动。此文件的确切位置及其应用方式取决于您的 MCP 客户端。

要启用 MCP 服务，请在 mcpServers 块中添加一个条目：

{
  "mcpServers": {
    "pushpad": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pushpad-mcp"],
      "env": {
        "PUSHPAD_TOKEN": "${PUSHPAD_TOKEN}"
      }
    }
  }
}

上面的示例使用 ${PUSHPAD_TOKEN} 配置了 Pushpad MCP 服务器。请将其替换为您的 Pushpad 令牌，或使用客户端特定的变量替换方法（如果有）将令牌保留在配置文件之外。

步骤 3：使用 Pushpad MCP

最后，您可以使用 MCP 和您的 AI 代理与 Pushpad 进行交互。

例如：

使用 Pushpad 向所有人发送关于 XYZ 的通知。

使用 Pushpad 向用户 123 发送通知。

通知 98765 获得了多少次点击？

项目 456 中通知的默认 TTL 是多少？

MCP 服务器支持完整的 Pushpad API，包括通知 API、订阅 API、项目 API 和发送者 API。

开发

如果您想为该项目做出贡献，请随时提出问题或提交拉取请求。

如果您想修改此包以进行本地开发，可以克隆此仓库并使用 VS Code 配合 开发容器 以更轻松地设置。

然后您可以使用以下命令：

• npm run build 编译 TypeScript 项目

• npm run start 启动 MCP 服务器

• npm run inspect 启动 MCP 服务器并通过 @modelcontextprotocol/inspector 检查它

您可以在 .env 文件中设置 PUSHPAD_TOKEN，它会自动被读取。

此仓库还在开发容器中包含了 Claude Code 和一个 .mcp.json 文件，您可以使用它们来尝试此 MCP 服务器的本地版本。这仅当您计划对此包进行修改并希望在提交拉取请求之前试用修改后的版本时才有用。

许可证

此 MCP 服务器根据开源许可证（MIT）发布。