lmol-4/alert-my-human

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

96 stars 0 forks 품질 79 트렌드 29MIT

Repository Install

에이전트에서 인간에게 다중 채널 경고를 보내는 경량 MCP 서버입니다.

개요

작업이 완료되었거나, 작업 실패가 발생하거나, 주의가 필요하면 상담원이 알려주도록 하세요. 이메일, 슬랙, 텔레그램, SMS, 웹훅을 통해 알림을 보내세요. 개인 자동화를 위한 작은 MCP 서버. 데이터베이스, 큐, 백그라운드 서비스가 없습니다. 본인이 직접 제공자 자격 증명을 지참하세요; 호스팅 및 알림 제공자는 사용 시 요금이 부과될 수 있습니다. 하나만 설정해 시작하세요. 나머지 변수는 설정하지 마세요. AUTH_API_KEY 제공자 자격 증명과는 별개의 긴 무작위 비밀로 설정하세요: AUTH_API_KEY 입력 버튼을 누르세요. 프로젝트 환경 설정에서 프로덕션용 채널 변수를 추가한 후, 다시 배포해서 그 변수들이 효과를 발휘하도록 하세요. 엔드포인트는 https:// /api/mcp입니다. .env.example을 .env로 복사하고, 키와 채널 변수를 설정한 후 pnpm dev를 실행하세요. 엔드포인트는 [[T0]입니다. 프로세스를 계속 실행하세요; 원격 클라이언트는 컴퓨터의 로컬 호스트에 접근할 수 없습니다. 커스텀 헤더가 있는 HTTP 서버를 지원하는 MCP 클라이언트를 사용하세요.

개요(AI 번역)

작업이 완료되었거나, 작업 실패가 발생하거나, 주의가 필요하면 상담원이 알려주도록 하세요. 이메일, 슬랙, 텔레그램, 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로 봇을 만들고 메시지를 보내고, 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 "
      }
    }
  }
}

GitHub에서 전체 README 보기

설치

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