Skip to main content
Glama
deenesjakoruzh

ntfy-me-mcp

by gitmotion
npmGitHub
JavaScript
GPL 3.0
548
29
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

📤 ntfy-me-mcp

Оптимизированный сервер Model Context Protocol (MCP) для отправки уведомлений через службу ntfy (публичную или размещенную на собственном сервере с поддержкой токенов) 📲

Обзор

ntfy-me-mcp предоставляет помощникам ИИ возможность отправлять уведомления в реальном времени на ваши устройства через службу ntfy (публичную или размещенную на собственном сервере с поддержкой токенов). Получайте уведомления, когда ваш ИИ завершает задачи, сталкивается с ошибками или достигает важных этапов — и все это без постоянного мониторинга.

Сервер включает в себя интеллектуальные функции, такие как автоматическое определение URL-адресов для создания действий просмотра и интеллектуальное определение форматирования разметки, что упрощает для помощников на базе искусственного интеллекта создание насыщенных интерактивных уведомлений без дополнительной настройки.

Доступно через:

ИмяСсылка/Значок
Глама.ай
Кузница.ai
MseeP.ai

Оглавление

Функции

  • 🚀 Быстрая настройка : запуск с npx или docker!
  • 🔔 Уведомления в реальном времени : получайте обновления на свой телефон/настольный компьютер по завершении задач
  • 🎨 Расширенные уведомления : поддержка тем, заголовков, приоритетов, тегов эмодзи и подробных сообщений
  • 🔍 Извлечение уведомлений : извлечение и фильтрация кэшированных сообщений из ваших тем ntfy
  • 🎯 Ссылки Smart Action : автоматически определяет URL-адреса в сообщениях и создает действия просмотра
  • 📄 Интеллектуальная разметка : автоматически определяет и включает форматирование разметки при наличии
  • 🔒 Безопасность : дополнительная аутентификация с токенами доступа
  • 🔑 Маскировка ввода : надежно сохраните свой токен ntfy в конфигурации vs!
  • 🌐 Поддержка самостоятельного размещения : работает как с ntfy.sh, так и с самостоятельно размещенными экземплярами ntfy.

(Вскоре...)

  • 📨 Электронная почта : отправлять уведомления на электронную почту (требуется настройка почтового сервера ntfy)
  • 🔗 URL-адреса кликов : возможность настраивать URL-адреса кликов
  • 🖼️ URL-адреса изображений : интеллектуальное определение URL-адресов изображений для автоматического включения URL-адресов изображений в сообщения и уведомления.
  • 🏁 и многое другое!

Быстрый старт — конфигурация сервера MCP

NPM / NPX (рекомендуемый метод)

  • Требуется, чтобы в вашей системе были установлены npm / npx.
  • Этот метод рекомендуется большинству пользователей, поскольку он обеспечивает простой и легкий способ настройки сервера.

Для максимально простой настройки с помощью помощников, совместимых с MCP, добавьте в конфигурацию MCP следующее:

Минимальная конфигурация (для публичных тем на ntfy.sh)
{ "ntfy-me-mcp": { "command": "npx", "args": ["ntfy-me-mcp"], "env": { "NTFY_TOPIC": "your-topic-name" } } }
Полная конфигурация (для частных серверов или защищенных тем)
Вариант 1: Прямой токен в конфигурации
{ "ntfy-me-mcp": { "command": "npx", "args": ["ntfy-me-mcp"], "env": { "NTFY_TOPIC": "your-topic-name", "NTFY_URL": "https://your-ntfy-server.com", "NTFY_TOKEN": "your-auth-token" // Use if using a protected topic/server } } }
Вариант 2: использование входных данных VS Code для безопасной обработки токенов (рекомендуется)

Добавьте это в файл settings.json VS Code:

"mcp": { "inputs": [ { // Add this to your inputs array "type": "promptString", "id": "ntfy_token", "description": "Ntfy Token", "password": true } ], "servers": { // Other servers... "ntfy-me-mcp": { "command": "npx", "args": ["ntfy-me-mcp"], "env": { "NTFY_TOPIC": "your-topic-name", "NTFY_URL": "https://your-ntfy-server.com", "NTFY_TOKEN": "${input:ntfy_token}", // Use the input id variable for the token "PROTECTED_TOPIC": "true" // Prompts for token and masks it in your config } } } }

При такой настройке VS Code запросит токен при запуске сервера, и токен будет замаскирован при вводе.

Докер

Использование с MCP в Docker

  • Требуется, чтобы в вашей системе был установлен Docker.
  • Этот метод полезен для запуска сервера в контейнерной среде.
  • Вы можете использовать официальные образы Docker, доступные на Docker Hub или GitHub Container Registry.

Образы Docker:

  • gitmotion/ntfy-me-mcp:latest (Docker Hub)
  • ghcr.io/gitmotion/ntfy-me-mcp:latest (реестр контейнеров GitHub)

В конфигурации MCP (например, VS Code settings.json):

"mcp": { "servers": { "ntfy-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "NTFY_TOPIC", "-e", "NTFY_URL", "-e", "NTFY_TOKEN", "-e", "PROTECTED_TOPIC", "gitmotion/ntfy-me-mcp", // OR use ghcr.io/gitmotion/ntfy-me-mcp:latest ], "env": { "NTFY_TOPIC": "your-topic-name", "NTFY_URL": "https://your-ntfy-server.com", "NTFY_TOKEN": "${input:ntfy_token}", "PROTECTED_TOPIC": "true" } } } }

Установка

Если вам необходимо установить и запустить сервер напрямую (альтернатива конфигурации MCP, описанной выше):

Вариант 1: Глобальная установка

npm install -g ntfy-me-mcp

Вариант 2: Запуск с npx

npx ntfy-me-mcp

Вариант 3: Локальная установка

# Clone the repository git clone https://github.com/gitmotion/ntfy-me-mcp.git cd ntfy-me-mcp # Install dependencies npm install # Copy the example environment file and configure it cp .env.example .env # Edit .env with your preferred editor and update the variables # nano .env # or use your preferred editor # Build the project npm run build # Start the server npm start

Вариант 4: Сборка и локальное использование с помощью команды node

Если вы разрабатываете или настраиваете сервер, вам может потребоваться запустить его напрямую с помощью node:

# Clone the repository git clone https://github.com/gitmotion/ntfy-me-mcp.git cd ntfy-me-mcp # Install dependencies npm install # Copy the example environment file and configure it cp .env.example .env # Edit the .env file to set your NTFY_TOPIC and other optional settings # nano .env # or use your preferred editor # Build the project npm run build # Run using node directly npm start
Использование локально построенного сервера с MCP

При настройке MCP для использования локально собранной версии укажите команду node и путь к собранному файлу index.js:

{ "ntfy-me": { "command": "node", "args": ["/path/to/ntfy-mcp/build/index.js"], "env": { "NTFY_TOPIC": "your-topic-name", //"NTFY_URL": "https://your-ntfy-server.com", // Use if using a self-hosted server //"NTFY_TOKEN": "your-auth-token" // Use if using a protected topic/server } } }

Не забудьте указать абсолютный путь к файлу build/index.js в массиве args.

Вариант 5: Установки MCP Marketplace

Установка через Smithery

Чтобы автоматически установить ntfy-me-mcp для Claude Desktop через Smithery :

npx -y @smithery/cli install @gitmotion/ntfy-me-mcp --client claude

Конфигурация

Переменные среды

Создайте файл .env в каталоге вашего проекта, скопировав предоставленный пример:

# Copy the example file cp .env.example .env # Edit the file with your preferred editor nano .env # or vim, code, etc.

Ваш файл .env должен содержать следующие переменные:

# Required NTFY_TOPIC=your-topic-name # Optional - Configure these if using a private/protected ntfy server # NTFY_URL=https://ntfy.sh # Default is ntfy.sh, change to your self-hosted ntfy server URL if needed # Include port if needed, e.g., https://your-ntfy-server.com:8443 # NTFY_TOKEN=your-access-token # Required for authentication with protected topics/servers # PROTECTED_TOPIC=false # Set to "true" if your topic requires authentication (helps prevent auth errors)

Примечание : Флаг PROTECTED_TOPIC помогает приложению определить, требуется ли аутентификация для вашей темы. Если установлено значение "true" и токен не предоставлен, вам будет предложено ввести его. Это предотвращает сбои аутентификации с защищенными темами.

Использование

Аутентификация

Этот сервер поддерживает как аутентифицированные, так и неаутентифицированные конечные точки ntfy:

  • Публичные темы : при использовании публичных тем на ntfy.sh или других публичных серверах аутентификация не требуется.
  • Защищенные темы : для защищенных тем или частных серверов вам необходимо предоставить токен доступа.

Если аутентификация требуется, но не предоставлена, вы получите четкое сообщение об ошибке с пояснениями, как добавить свой токен.

Настройка приемника уведомлений

  1. Установите приложение ntfy на свое устройство
  2. Подпишитесь на выбранную вами тему (такую же, как ваша настройка NTFY_TOPIC )

Отправка уведомлений (инструмент ntfy_me)

В этом разделе рассматриваются все функции, связанные с отправкой уведомлений с помощью инструмента ntfy_me.

Использование естественного языка

При работе с вашим помощником на основе искусственного интеллекта вы можете использовать естественные фразы, например:

"Send me a notification when the build is complete" "Notify me when the task is done" "Alert me after generating the code" "Message me when the process finishes" "Send an alert with high priority"
Параметры сообщения

Инструмент принимает следующие параметры:

ПараметрОписаниеНеобходимый
taskTitleЗаголовок уведомленияДа
задачаРезюмеОрган уведомленияДа
приоритетПриоритет сообщения: мин., низк., по умолчанию, выс., макс.Нет
тегиМассив тегов уведомлений (поддерживает короткие коды эмодзи)Нет
уценкаЛогическое значение для включения форматирования markdown (true/false)Нет
действияМассив объектов действий просмотра для кликабельных ссылокНет

Пример:

{ taskTitle: "Code Generation Complete", taskSummary: "Your React component has been created successfully with proper TypeScript typing.", priority: "high", tags: ["check", "code", "react"] }

Это приведет к отправке высокоприоритетного уведомления с эмодзи в виде галочки.

Ссылки на действия

Вы можете добавлять в уведомления кнопки действий, на которые можно нажимать, используя параметр actions , или позволить серверу автоматически определять URL-адреса в вашем сообщении.

Автоматическое определение URL-адреса

Если в тексте сообщения присутствуют URL-адреса, сервер автоматически создает до 3 действий просмотра (максимальный лимит ntfy) из первых обнаруженных URL-адресов. Это позволяет легко включать кликабельные ссылки без ручного указания массива действий.

Например, это сообщение:

{ taskTitle: "Build Complete", taskSummary: "Your PR has been merged! View the changes at https://github.com/org/repo/pull/123 or check the deployment at https://staging.app.com" }

Автоматически сгенерирует действия просмотра для обоих URL-адресов, что позволит легко нажимать на них в уведомлении.

Конфигурация ручного действия

Для большего контроля вы можете вручную указать действия:

СвойствоОписаниеНеобходимый
действиеДолжно быть "вид"Да
этикеткаТекст кнопки для отображенияДа
URL-адресURL-адрес, который открывается при нажатииДа
прозрачныйОчищать ли уведомление при нажатии (необязательно)Нет

Пример со ссылками на действия:

{ taskTitle: "Pull Request Review", taskSummary: "Your code has been reviewed and is ready for final checks", priority: "high", tags: ["check", "code"], actions: [ { action: "view", label: "View PR", url: "https://github.com/org/repo/pull/123" }, { action: "view", label: "View Changes", url: "https://github.com/org/repo/pull/123/files", clear: true } ] }
Короткие коды эмодзи

Вы можете использовать короткие коды эмодзи в своих тегах для визуальных индикаторов:

  • warning → ⚠️
  • check → ✅
  • rocket → 🚀
  • tada → 🎉

Ознакомьтесь с полным списком поддерживаемых коротких кодов эмодзи .

Форматирование Markdown

Ваши уведомления поддерживают расширенное форматирование markdown с интеллектуальным обнаружением! Когда вы включаете синтаксис markdown в taskSummary , сервер автоматически обнаруживает его и включает парсинг markdown — нет необходимости явно устанавливать markdown: true .

Автоматическое обнаружение

Сервер проверяет общие шаблоны разметки, такие как:

  • Заголовки (#, ## и т.д.)
  • Списки (-, *, цифры)
  • Блоки кода (```)
  • Ссылки ( текст )
  • Жирный/курсив ( текст , текст )

При обнаружении таких шаблонов для сообщения автоматически включается синтаксический анализ разметки.

Ручное управление

Хотя автоматическое обнаружение работает в большинстве случаев, вы все равно можете явно контролировать синтаксический анализ разметки:

{ taskTitle: "Task Complete", taskSummary: "Regular plain text message", markdown: false // Force disable markdown parsing }

Извлечение сообщений (инструмент ntfy_me_fetch)

В этом разделе рассматриваются все функции, связанные с извлечением и фильтрацией сообщений с помощью инструмента ntfy_me_fetch.

Использование естественного языка

Помощники на основе искусственного интеллекта понимают различные способы запроса на получение сообщений:

"Show me my recent notifications" "Get messages from the last hour" "Find notifications with title 'Build Complete'" "Search for messages with the test_tube tag" "Show notifications from the updates topic from the last 24hr" "Check my latest alerts"
Параметры сообщения

Инструмент принимает следующие параметры:

ПараметрОписаниеНеобходимый
ntfyТемаТема для извлечения сообщений (по умолчанию — переменная окружения NTFY_TOPIC)Нет
сНасколько давно следует извлекать сообщения («10m», «1h», «1d», временная метка, идентификатор сообщения или «все»)Нет
сообщениеIdНайти конкретное сообщение по его идентификаторуНет
сообщениеТекстНайти сообщения, содержащие точное текстовое содержаниеНет
messageTitleНайти сообщения с точным заголовком/темойНет
приоритетыНайдите сообщения с определенными уровнями приоритетаНет
тегиНайти сообщения с определенными тегамиНет
Примеры
  1. Получить последние сообщения
{ since: "30m" // Get messages from last 30 minutes }
  1. Фильтр по названию и приоритету
{ messageTitle: "Build Complete", priorities: "high", since: "1d" }
  1. Поиск по разным темам с тегами
{ ntfyTopic: "updates", tags: ["error", "warning"], since: "all" }
  1. Найти конкретное сообщение
{ messageId: "xxxxXXXXxxxx" }

Сообщения возвращаются с полной информацией, включая:

  • Идентификатор сообщения и временная метка
  • Тема и название
  • Содержание и приоритет
  • Теги и вложения
  • Ссылки на действия и истечение срока действия

Примечание : Доступность истории сообщений зависит от настроек кэша вашего сервера ntfy. Публичный сервер ntfy.sh обычно кэширует сообщения на 12 часов.

Разработка

Строительство из источника

git clone https://github.com/gitmotion/ntfy-me-mcp.git cd ntfy-me-mcp npm install npm run build

Лицензия

Данный проект лицензирован в соответствии с лицензией GNU General Public License v3.0 — подробности см. в файле LICENSE .

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Сделано с ❤️ от gitmotion

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Оптимизированный сервер MCP, который позволяет помощникам на основе искусственного интеллекта отправлять уведомления в режиме реального времени на ваши устройства через службу ntfy, позволяя вам получать оповещения о завершении задач или возникновении важных событий.

  1. Обзор
    1. Доступно через:
  2. Оглавление
    1. Функции
      1. (Вскоре...)
    2. Быстрый старт — конфигурация сервера MCP
      1. NPM / NPX (рекомендуемый метод)
    3. Докер
      1. Использование с MCP в Docker
    4. Установка
      1. Вариант 1: Глобальная установка
      2. Вариант 2: Запуск с npx
      3. Вариант 3: Локальная установка
      4. Вариант 4: Сборка и локальное использование с помощью команды node
      5. Вариант 5: Установки MCP Marketplace
    5. Конфигурация
      1. Переменные среды
    6. Использование
      1. Аутентификация
      2. Настройка приемника уведомлений
      3. Отправка уведомлений (инструмент ntfy_me)
      4. Извлечение сообщений (инструмент ntfy_me_fetch)
    7. Разработка
      1. Строительство из источника
    8. Лицензия
      1. Внося вклад

        Related MCP Servers

        • ntfy-mcp

          teddyzxcv
          -
          security
          A
          license
          -
          quality
          The MCP server that keeps you informed by sending the notification on phone using ntfy.sh
          Last updated -
          9
          30
          JavaScript
          Apache 2.0
          • Linux
          • Apple

        • NTFY MCP Server

          cyanheads
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server enabling AI systems to send real-time notifications to phones, desktops, and other devices through the ntfy publish/subscribe service.
          Last updated -
          9
          12
          TypeScript
          Apache 2.0
          • Apple

        • Notion MCP Serverofficial

          makenotion
          A
          security
          A
          license
          A
          quality
          An MCP server that enables AI assistants to interact with the Notion API, allowing them to search, read, comment on, and create content in Notion workspaces through natural language commands.
          Last updated -
          19
          11,266
          2,752
          TypeScript
          MIT License
          • Apple

        • TickTick MCP Server

          jen6
          -
          security
          F
          license
          -
          quality
          An MCP server that enhances TickTick workflow by providing comprehensive task management tools with improved filtering capabilities, allowing AI assistants and MCP-compatible applications to interact with TickTick tasks with greater precision.
          Last updated -
          24
          Python

        View all related MCP servers

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/gitmotion/ntfy-me-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server