lmol-4/alert-my-human

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

96 stars 0 forks 质量 79 趋势 29MIT

Repository Install

轻量级MCP服务器，用于从代理向人类发送多通道警报。

概览

让你的客服在任务完成、任务失败或需要你关注时通知你。通过电子邮件、Slack、Telegram、短信或webhook发送提醒。一个小型MCP服务器用于个人自动化。没有数据库、队列或后台服务。请自带供应商凭证;托管和通知提供商可能会对使用收费。只配置一个变量开始。其他变量保持不设置。将AUTH_API_KEY设置为一个长的随机秘密，与你的提供者凭证分开：提示时输入AUTH_API_KEY。在项目环境设置中添加你的频道变量以实现生产环境，然后重新部署使其生效。你的终端节点是 https:// /api/mcp。将 .env.example 复制到 .env，设置键和通道变量，然后运行 pnpm dev。端点是 http://localhost:3000/api/mcp. 保持进程运行;远程客户端无法访问你电脑的本地主机。使用支持带有自定义头部的 HTTP 服务器的 MCP 客户端。

概述（AI 翻译）

让你的客服在任务完成、任务失败或需要你关注时通知你。通过电子邮件、Slack、Telegram、短信或webhook发送提醒。

一个小型MCP服务器用于个人自动化。没有数据库、队列或后台服务。请自带供应商凭证;托管和通知提供商可能会对使用收费。

快速启动（MCP服务器）

1.选择频道

只配置一个变量开始。其他变量保持不设置。

通道	变量	设置
`email`	`RESEND_API_KEY`， `SENDING_EMAIL`， `ALERT_EMAIL`（若干部分用逗号分隔）	重发：API密钥和已验证的发送域
`slack`	`SLACK_WEBHOOK_URL`	有 webhook 来了;把 URL 当作秘密
`telegram`	`TELEGRAM_BOT_TOKEN`， `TELEGRAM_CHAT_ID`	创建一个带有@BotFather的机器人，给它发消息，然后阅读 getUpdates
`sms`	`TWILIO_ACCOUNT_SID`， `TWILIO_AUTH_TOKEN`， `TWILIO_FROM_NUMBER`， `ALERT_PHONE_NUMBER`	Twilio;国际格式的数字，例如 `+353...`
网钩	`WEBHOOK_URLS`，可选 `WEBHOOK_SECRET`	参见网钩

将AUTH_API_KEY设置为一个长随机秘密，与你的提供者凭证分开：

2.

本页由 AI 翻译，技术细节请以原文为准。

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 "
      }
    }
  }
}

在 GitHub 查看完整 README

安装

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

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

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