Skip to main content
Glama
deenesjakoruzh
gitmotion

ntfy-me-mcp

by gitmotion
OverviewInspectSchemaRelated ServersScoreDiscussions
JavaScript
Remote

📤 ntfy-me-mcp

Машинопись Модель контекстного протокола Версия НПМ Версия образа Docker Лицензия GitHub

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

Обзор

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

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

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

Имя

Ссылка/Значок

Глама.ай

Кузница.ai

значок кузнеца

MseeP.ai

Related MCP server: NTFY MCP Server

Оглавление

Функции

  • 🚀 Быстрая настройка : запуск с 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

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

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