ntfy-mcp-server

ntfy MCP サーバー

Model Context Protocol (MCP) サーバーです。ntfy.sh を通じて、AI アシスタントからプッシュ通知を送信できます。このサーバーを使うと、リアルタイム通知を AI ワークフローに簡単に統合でき、ntfy.sh に対応したスマートフォン、デスクトップ、その他のデバイスでアラートを受け取れます。

ntfy.sh とは？

ntfy.sh は、デバイスにプッシュ通知を送信できる、シンプルな HTTP ベースの Pub/Sub 通知サービスです。特に次のような用途に便利です。

• 時間のかかるタスクが完了したときに通知を受け取る
• 自動化されたワークフローからアラートを受け取る
• アプリケーションの重要なイベントを把握する

機能

• 任意の ntfy.sh チャンネルにメッセージを送信
• メッセージのタイトル、優先度（1～5）、タグに対応
• MCP 対応の AI アシスタントと簡単に連携
• パブリックチャンネルでは認証不要

インストール

1. 依存関係をインストールします。

npm install --save-dev typescript @types/node ts-node

2. TypeScript コードをビルドします。

npm run build

3. MCP サーバーを ./build/index.js から利用できるようになります。

使い方

サーバーの実行

ビルド後、サーバーを直接実行できます。

npm start

または、MCP クライアントでビルド済みサーバー ./build/index.js を指定してください。

利用可能なツール

サーバーは次のツールを提供します。

send_message

指定した ntfy.sh チャンネルにメッセージを送信します。

パラメーター：

• channel（必須）：メッセージの送信先となる ntfy.sh チャンネル名
• message（必須）：送信するメッセージの内容
• title（任意）：通知のタイトル
• priority（任意）：優先度（1～5、5 が最高）
• tags（任意）：メッセージを分類するタグの配列

MCP クライアントでの使用例：

{
  "tool": "send_message",
  "arguments": {
    "channel": "my-notifications",
    "message": "Task completed successfully!",
    "title": "Workflow Update",
    "priority": 4,
    "tags": ["automation", "success"]
  }
}

設定

追加の設定は不要です。サーバーはパブリックな ntfy.sh サービス https://ntfy.sh/ を使用します。

チャンネル名

• チャンネル名には任意の文字列を使用できますが、競合を避けるため一意の名前にしてください
• my-project-alerts や personal-notifications のような、わかりやすい名前を使うことをおすすめします
• チャンネル名を知っている人は誰でもメッセージを送信できるため、名前は慎重に選んでください

開発

ビルドスクリプト

• npm run build - TypeScript を JavaScript にコンパイルします
• npm run build:linux - Linux 向けにビルドし、実行可能にします
• npm run build:windows - Windows 向けにビルドします
• npm start - コンパイル済みサーバーを実行します

プロジェクト構成

• src/index.ts - メインのサーバー実装
• build/index.js - ビルド後のコンパイル済み JavaScript 出力

ライセンス

詳細は LICENSE ファイルを参照してください。