Fastalert Mcp Server

FastAlert MCP サーバー

FastAlert の公式 Model Context Protocol（MCP）サーバーです。このサーバーを使うと、AI エージェント（Claude、ChatGPT、Cursor など）からチャンネルの一覧を取得し、FastAlert API を通じて通知を直接送信できます。

機能

• チャンネルの検索：名前による任意のフィルターを指定して、すべてのチャンネルを一覧表示します。
• 通知の送信：リッチメッセージ（タイトル、本文、アクション、画像）を 1 つまたは複数のチャンネルに送信します。

クイックスタート

{
  "mcpServers": {
    "fastalert": {
      "command": "npx",
      "args": ["-y", "fastalert-mcp-server"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

API キーは、FastAlert にアクセスして Settings に移動すると確認できます。

利用可能なツール

この MCP サーバーでは、以下のツールを利用できます。各ツールは、AI アシスタントから呼び出して特定の操作を実行できます。

1. list_channels

利用可能な FastAlert チャンネルの一覧を返します。

入力パラメーター：

• name（文字列、任意）：チャンネルを名前で絞り込むための検索語句です。

呼び出し例：

{
  "name": "Service Alerts"
}

構造化 JSON 出力（デフォルト）：

{
  "status": true,
  "message": "You have fetch channels successfully",
  "data": {
    "channels": [
      {
        "uuid": "sdf12sdf-6541-5d56-s5sd-1fa513e88a81",
        "name": "Service Alerts",
        "subscriber": 1000
      }
    ]
  }
}

人が読みやすいテキスト出力：

Here are your FastAlert channels:

Service Alerts
UUID: sdf12sdf-6541-5d56-s5sd-1fa513e88a81
Subscribers: 1000

2. send_message

1 つまたは複数のチャンネルに通知メッセージを送信します。

入力パラメーター：

• channel-uuid（文字列、必須）：送信先チャンネルの一意の識別子です。
• title（文字列、必須）：通知のタイトルです。
• content（文字列、必須）：通知の本文です。
• action（文字列、任意）：アクションの種類（'call'、'email'、'website'、'image'）です。
• action_value（文字列、任意）：アクションの値（URL や電話番号など）です。
• image（文字列、任意）：追加する画像の URL または識別子です。

呼び出し例：

{
  "channel-uuid": "sdf12sdf-6541-5d56-s5sd-1fa513e88a81",
  "title": "System Update",
  "content": "A new version of the system is now live.",
  "action": "website",
  "action_value": "https://fastalert.now/updates"
}

構造化 JSON 出力（デフォルト）：

{
  "status": true,
  "message": "Message has been sent successfully"
}

人が読みやすいテキスト出力：

Message Sent Successfully!

Your message "System Update" has been sent to Service Alerts.

Channel UUID: sdf12sdf-6541-5d56-s5sd-1fa513e88a81
Title: System Update
Content: A new version of the system is now live.

LLM との連携

Cursor の設定

1. Settings -> MCP に移動します。
2. Add New MCP Server をクリックします。
3. 名前：FastAlert
4. 種類：command
5. コマンド：npx -y fastalert-mcp-server
6. Env：API_KEY を追加します。

ChatGPT の設定

1. Settings -> Integrations に移動します。
2. Add MCP Server をクリックします。
3. サーバーのホスト URL（例：https://mcp.fastalert.now/mcp）を使用します。
4. OAuth のプロンプトに従います。

Claude の設定

1. claude_desktop_config.json を開きます。
2. 以下のエントリを追加します。

{
  "mcpServers": {
    "fastalert": {
      "command": "npx",
      "args": ["-y", "fastalert-mcp-server"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

セットアップと開発

必要条件

• Node：バージョン 18 以降を推奨します。
• API_KEY：認証には有効な FastAlert API キーが必要です。

ローカルインストール

1. リポジトリをクローンします
2. サンプルの環境ファイルをコピーします。

   cp .env.example .env
   

3. .env で環境変数を設定します。
4. 依存関係をインストールします。

   npm install
   

5. プロジェクトをビルドします。

   npm run build
   

6. インスペクターのテストを実行します。

   npm run inspector
   

7. ローカルで実行します。

   npm start
   

設定（環境変数）

以下の環境変数を .env ファイルで設定してください。

変数	説明	例
API_URL	FastAlert API のエンドポイント	https://api.fastalert.now/api
FRONT_URL	フロントエンドアプリケーションの URL	https://fastalert.now
BASE_URL	この MCP サーバーがホストされる公開 URL	http://localhost:3000
API_KEY	FastAlert API キー	your-api-key-here
PORT	（任意）サーバーの実行に使用するポート	3000

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。

---