MMCPMarkets
L4

lmol-4/alert-my-human

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

96 stars 0 forks Качество 79 Тренд 29MIT
Repository Install

Лёгкий MCP-сервер для отправки многоканальных оповещений от агентов к людям.

Обзор

Позвольте агенту уведомлять вас о завершении задачи, провале или необходимости вашего внимания. Отправляйте уведомления по электронной почте, Slack, Telegram, SMS или вебхукам. Небольшой MCP-сервер для персональных автоматизаций. Нет базы данных, очереди или фоновых сервисов. Возьмите с собой учетные данные провайдера; хостинг и провайдеры уведомлений могут брать плату за использование. Настройте только одну для начала. Остальные переменные оставьте незамеченными. Установите AUTH_API_KEY на длинный случайный секрет, отдельный от ваших учётных данных провайдера: Введите AUTH_API_KEY по запросу. Добавьте переменные канала в настройки среды проекта для продакшена, затем переразвертите их так, чтобы они вступили в силу. Ваш конечный пункт — https:// /api/mcp. Скопируйте .env.example в .env, задайте ключевые и каналные переменные, затем запустите pnpm dev. Конечная точка — http://localhost:3000/api/mcp. Поддерживайте процесс в работе; удалённый клиент не может связаться с локальным хостом вашего компьютера. Используйте MCP-клиент, который поддерживает HTTP-серверы с кастомными заголовками.

Обзор (машинный перевод)

Позвольте агенту уведомлять вас о завершении задачи, провале или необходимости вашего внимания. Отправляйте уведомления по электронной почте, Slack, Telegram, SMS или вебхукам.

Небольшой MCP-сервер для персональных автоматизаций. Нет базы данных, очереди или фоновых сервисов. Возьмите с собой учетные данные провайдера; хостинг и провайдеры уведомлений могут брать плату за использование.

Быстрый старт (сервер MCP)

1. Выберите канал

Настройте только одну для начала. Остальные переменные оставьте незамеченными.

Канал Переменные Настройка
email RESEND_API_KEY, SENDING_EMAIL, ALERT_EMAIL (запятая разделена для нескольких) Переотправить: ключ API и проверенный домен отправления
slack SLACK_WEBHOOK_URL Входящий вебхук; воспринимайте URL как секрет
telegram TELEGRAM_BOT_TOKEN, [TELEGRAM_CHAT_ID Создайте бота на @BotFather, отправьте ему сообщение, затем прочитайте message.chat.id с getUpdates
sms TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_FROM_NUMBER, ALERT_PHONE_NUMBER Twilio; номера в международном формате, например +353...
вебхуки WEBHOOK_URLS, необязательные WEBHOOK_SECRET См. вебхуки

Установите AUTH_API_KEY на длинный случайный секрет, отдельно от ваших учётных данных провайдера:

2.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

alert-my-human

Let your agent notify you when a task finishes, a job fails, or it needs your attention. Send alerts through email, Slack, Telegram, SMS, or webhooks.

A small MCP server for personal automations. No database, queue, or background service. Bring your own provider credentials; hosting and notification providers may charge for usage.

Quick start (MCP server)

1. Choose a channel

Configure just one to begin. Leave the other variables unset.

Channel Variables Setup
email RESEND_API_KEY, SENDING_EMAIL, ALERT_EMAIL (comma-separated for several) Resend: API key and a verified sending domain
slack SLACK_WEBHOOK_URL Incoming webhook; treat the URL as a secret
telegram TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID Create a bot with @BotFather, message it, then read message.chat.id from getUpdates
sms TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_FROM_NUMBER, ALERT_PHONE_NUMBER Twilio; numbers in international format, e.g. +353...
webhooks WEBHOOK_URLS, optional WEBHOOK_SECRET See Webhooks

Set AUTH_API_KEY to a long random secret, separate from your provider credentials:

node -e "console.log(require('node:crypto').randomBytes(32).toString('hex'))"

2. Run the server

Vercel — no local server to keep running:

Enter AUTH_API_KEY when prompted. Add your channel variables in the project’s environment settings for Production, then redeploy so they take effect. Your endpoint is https:///api/mcp.

Locally — Node.js 24 and pnpm 12.9.1:

git clone https://github.com/LMol-4/alert-my-human.git
cd alert-my-human
pnpm install --frozen-lockfile

Copy .env.example to .env, set your key and channel variables, then run pnpm dev. The endpoint is http://localhost:3000/api/mcp. Keep the process running; a remote client cannot reach your computer’s localhost.

3. Connect your agent

Use an MCP client that supports HTTP servers with custom headers. For clients using mcpServers configuration:

{
  "mcpServers": {
    "alert-my-human": {
      "type": "http",
      "url": "https:///api/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "mcpServers": { "alert-my-human": { "type": "http", "url": "https://<your-domain>/api/mcp", "headers": { "Authorization": "Bearer <AUTH_API_KEY>" } } } }