Pushpad MCP

Pushpad MCP-сервер для отправки веб-push-уведомлений и управления ресурсами в Pushpad (CRUD-операции над уведомлениями, подписками, проектами и отправителями) с помощью Pushpad API.

Этот проект представляет собой тонкий слой поверх Pushpad API, использующий официальную спецификацию Pushpad OpenAPI и FastMCP для TypeScript.

Безопасность

Использование технологии MCP для взаимодействия с вашим аккаунтом Pushpad может быть связано с рисками.

Этот MCP-сервер предоставляет полный доступ к Pushpad API, который включает необратимые и деструктивные действия (например, обновление, удаление и т.д.). API также может возвращать конфиденциальные данные, такие как ключи push-подписок (Subscriptions API) и VAPID-ключи (Senders API).

Мы рекомендуем использовать соответствующий режим разрешений в вашем агенте и токен Pushpad с ограниченным доступом.

Вы можете изменить режим разрешений на Вручную или установить разрешения allow / deny для различных инструментов, предоставляемых этим MCP-сервером, в настройках вашего агента.

Мы рекомендуем исключить VAPID-ключи, хранящиеся в Senders, из контекста вашего ИИ: вы можете либо использовать токен Pushpad с ограниченным доступом, либо запретить инструменты, дающие доступ к Senders API.

Помните, что токен доступа должен оставаться конфиденциальным и никогда не должен храниться в Git-репозитории.

Related MCP server: Dialpad Universal MCP Server

Установка

Шаг 1: Настройка токена API в качестве переменной окружения

Сначала необходимо создать новый токен Pushpad: откройте панель управления Pushpad, нажмите на имя вашего аккаунта, затем выберите Access tokens и создайте новый токен.

Затем необходимо сохранить токен Pushpad как переменную окружения. Вы можете задать его глобально на вашем компьютере (~/.bashrc, ~/.zshrc или в другом профиле оболочки), использовать менеджер паролей (например, 1Password CLI), задать его в файле .env для конкретного проекта или добавить непосредственно в файл конфигурации MCP-клиента (например, .mcp.json). Не забудьте добавить .env, .mcp.json или другие файлы, которые могут содержать секрет, в .gitignore.

Шаг 2: Добавление MCP-сервера в вашего ИИ-агента

Локальный MCP-сервер запускается непосредственно вашим MCP-клиентом с использованием настроек, определённых в вашем JSON-файле конфигурации MCP. Точное расположение этого файла и способ его применения зависят от вашего MCP-клиента.

Чтобы включить MCP-сервисы, добавьте запись в блок mcpServers:

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

В приведённом выше примере настроен Pushpad MCP-сервер с ${PUSHPAD_TOKEN}. Замените его на ваш токен Pushpad или используйте специфичный для клиента метод подстановки переменных (если доступен), чтобы не хранить токен в конфигурационном файле.

Шаг 3: Использование Pushpad MCP

Наконец, вы можете взаимодействовать с Pushpad через MCP с помощью вашего ИИ-агента.

Например:

Используй Pushpad, чтобы отправить всем уведомление о XYZ.

Отправь уведомление пользователю 123 с помощью Pushpad.

Сколько кликов получило уведомление 98765?

Какое значение TTL по умолчанию для уведомлений в проекте 456?

MCP-сервер поддерживает полный API Pushpad, включая Notifications API, Subscriptions API, Projects API и Senders API.

Разработка

Если вы хотите внести вклад в этот проект, не стесняйтесь создавать issue или отправлять pull request.

Если вы хотите внести изменения в этот пакет для локальной разработки, вы можете клонировать этот репозиторий и использовать VS Code с dev-контейнером для более простой настройки.

Затем вы можете использовать следующие команды:

• npm run build для компиляции TypeScript-проекта

• npm run start для запуска MCP-сервера

• npm run inspect для запуска MCP-сервера и его инспекции с помощью @modelcontextprotocol/inspector

Вы можете задать PUSHPAD_TOKEN в файле .env, и он будет прочитан автоматически.

Этот репозиторий также включает Claude Code в dev-контейнере и файл .mcp.json, который можно использовать для тестирования локальной версии этого MCP-сервера. Это полезно только в том случае, если вы планируете вносить изменения в этот пакет и хотите опробовать модифицированную версию перед отправкой pull request.

Лицензия

Этот MCP-сервер выпущен под лицензией с открытым исходным кодом (MIT).