Pushpad MCP

Pushpad MCP-Server zum Senden von Web-Push-Benachrichtigungen und Verwalten von Ressourcen auf Pushpad (CRUD-Aktionen für Benachrichtigungen, Abonnements, Projekte und Absender) unter Verwendung der Pushpad API.

Dieses Projekt ist eine dünne Schicht, die auf der Pushpad-API aufbaut und die offizielle Pushpad OpenAPI-Spezifikation sowie FastMCP für TypeScript verwendet.

Sicherheit

Die Verwendung der MCP-Technologie zur Interaktion mit Ihrem Pushpad-Konto kann mit Risiken verbunden sein.

Dieser MCP-Server gewährt vollständigen Zugriff auf die Pushpad-API, einschließlich irreversibler und destruktiver Aktionen (wie Aktualisieren, Löschen usw.). Die API kann auch sensible Daten wie Push-Abonnementschlüssel (Abonnements-API) und VAPID-Schlüssel (Absender-API) zurückgeben.

Wir empfehlen die Verwendung eines geeigneten Berechtigungsmodus in Ihrem Agenten und die Verwendung eines Pushpad-Tokens mit eingeschränktem Zugriff.

Sie können den Berechtigungsmodus in Ihren Agenteneinstellungen auf Manuell ändern oder Erlauben / Verweigern-Berechtigungen für die verschiedenen von diesem MCP-Server bereitgestellten Tools festlegen.

Wir empfehlen, die in den Absendern gespeicherten VAPID-Schlüssel aus Ihrem KI-Kontext auszuschließen: Sie können entweder ein Pushpad-Token mit eingeschränktem Zugriff verwenden oder die Tools verweigern, die Zugriff auf die Absender-API gewähren.

Denken Sie daran, den Zugriffstoken privat zu halten und niemals im Git-Repository zu speichern.

Related MCP server: Dialpad Universal MCP Server

Installation

Schritt 1: Richten Sie Ihr API-Token als Umgebungsvariable ein

Zuerst müssen Sie einen neuen Pushpad-Token erstellen: Öffnen Sie das Pushpad-Dashboard, klicken Sie auf Ihren Kontonamen, dann auf Zugriffstoken und erstellen Sie einen neuen Token.

Dann müssen Sie den Pushpad-Token als Umgebungsvariable speichern. Sie können ihn global auf Ihrem Rechner setzen (~/.bashrc, ~/.zshrc oder ein anderes Shell-Profil), einen Passwortmanager (wie 1Password CLI) verwenden, ihn in einer projektspezifischen .env-Datei setzen oder direkt zur MCP-Client-Konfigurationsdatei (wie .mcp.json) hinzufügen. Denken Sie daran, .env, .mcp.json oder andere Dateien, die das Geheimnis enthalten könnten, zu .gitignore hinzuzufügen.

Schritt 2: Fügen Sie den MCP-Server zu Ihrem KI-Agenten hinzu

Der lokale MCP-Server wird direkt von Ihrem MCP-Client gestartet, der die in Ihrer MCP-JSON-Konfigurationsdatei definierten Einstellungen verwendet. Der genaue Speicherort dieser Datei und wie sie angewendet wird, hängt von Ihrem MCP-Client ab.

Um die MCP-Dienste zu aktivieren, fügen Sie einen Eintrag zum Block mcpServers hinzu:

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

Das obige Beispiel konfiguriert den Pushpad MCP-Server mit ${PUSHPAD_TOKEN}. Ersetzen Sie ihn durch Ihren Pushpad-Token oder verwenden Sie die clientspezifische Methode der Variablenersetzung (falls verfügbar), um Ihren Token aus der Konfigurationsdatei herauszuhalten.

Schritt 3: Verwenden Sie den Pushpad MCP

Schließlich können Sie über MCP und Ihren KI-Agenten mit Pushpad interagieren.

Zum Beispiel:

Verwenden Sie Pushpad, um allen eine Benachrichtigung über XYZ zu senden.

Senden Sie eine Benachrichtigung an Benutzer 123 mit Pushpad.

Wie viele Klicks hat die Benachrichtigung 98765 erhalten?

Was ist das standardmäßige TTL für Benachrichtigungen in Projekt 456?

Der MCP-Server unterstützt die vollständige Pushpad-API, einschließlich der Benachrichtigungs-API, Abonnements-API, Projekte-API und Absender-API.

Entwicklung

Wenn Sie zu diesem Projekt beitragen möchten, können Sie gerne ein Issue eröffnen oder einen Pull-Request einreichen.

Wenn Sie Änderungen an diesem Paket vornehmen möchten, können Sie für die lokale Entwicklung dieses Repository klonen und VS Code mit einem Dev-Container für eine einfachere Einrichtung verwenden.

Dann können Sie die folgenden Befehle verwenden:

• npm run build, um das TypeScript-Projekt zu kompilieren

• npm run start, um den MCP-Server zu starten

• npm run inspect, um den MCP-Server zu starten und mit @modelcontextprotocol/inspector zu inspizieren

Sie können PUSHPAD_TOKEN in einer .env-Datei setzen, und es wird automatisch ausgelesen.

Dieses Repository enthält auch Claude Code im Dev-Container und eine .mcp.json, die Sie verwenden können, um die lokale Version dieses MCP-Servers zu testen. Dies ist nur nützlich, wenn Sie planen, Änderungen an diesem Paket vorzunehmen, und Sie die modifizierte Version testen möchten, bevor Sie einen Pull-Request einreichen.

Lizenz

Dieser MCP-Server wird unter einer Open-Source-Lizenz (MIT) veröffentlicht.