lmol-4/alert-my-human
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
エージェントから人間へのマルチチャネルアラート送信のための軽量MCPサーバー。
概要
タスクが完了したときや作業が失敗したとき、または対応が必要なときはエージェントに通知してもらいましょう。メール、Slack、Telegram、SMS、ウェブフックなどでアラートを送信しましょう。 個人用自動化のための小型MCPサーバー。データベース、キュー、バックグラウンドサービスはありません。ご自身のプロバイダー認証情報を持参してください。ホスティングや通知プロバイダーは利用料を請求する場合があります。 最初は1つだけ設定します。他の変数は設定せずに。 プロバイダーの認証情報とは別の長いランダムな秘密に設定AUTH_API_KEY: 入力を促されたらAUTH_API_KEY入力してください。プロジェクトの環境設定で本番用にチャネル変数を追加し、再デプロイして効果を発揮します。エンドポイントは https:// /api/mcpです。 .env.exampleを.envにコピーし、キーとチャネル変数を設定してからpnpm devを実行します。エンドポイントはhttp://localhost:3000/api/mcp.で、プロセスを実行させ続けます。リモートクライアントはあなたのコンピュータのローカルホストにアクセスできません。 カスタムヘッダーを持つHTTPサーバーをサポートするMCPクライアントを使いましょう。
概要（AI 翻訳）
タスクが完了したときや作業が失敗したとき、または対応が必要なときはエージェントに通知してもらいましょう。メール、Slack、Telegram、SMS、ウェブフックなどでアラートを送信しましょう。
個人用自動化のための小型MCPサーバー。データベース、キュー、バックグラウンドサービスはありません。ご自身のプロバイダー認証情報を持参してください。ホスティングや通知プロバイダーは利用料を請求する場合があります。
クイックスタート(MCPサーバー)
1.チャンネルを選びましょう
最初は1つだけ設定します。他の変数は設定せずに。
| チャネル | 変数 | セットアップ |
|---|---|---|
email |
RESEND_API_KEY、SENDING_EMAIL、ALERT_EMAIL(いくつかはカンマ区切り) |
再送信:APIキーと認証済み送信ドメイン |
slack |
SLACK_WEBHOOK_URL |
着信ウェブフック;URLを秘密として扱う |
telegram |
TELEGRAM_BOT_TOKEN、TELEGRAM_CHAT_ID |
@BotFatherでボットを作成し、メッセージを送り、getUpdates |
sms |
TWILIO_ACCOUNT_SID、TWILIO_AUTH_TOKEN、TWILIO_FROM_NUMBER、ALERT_PHONE_NUMBER |
トゥイリオ;国際フォーマットの数字、例:+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 "
}
}
}
}
インストール
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>"
}
}
}
}