Gallabox MCP Server

🚀 Gallabox MCP サーバ

Gallabox API の MCP（メッセージ通信プロトコル）サーバで、WhatsApp とのメッセージ交換機能を実現します。

✨ 主な機能

sendTextMessage

• WhatsAppにテキストメッセージを送信します。
• 必要な入力:
  • recipient (オブジェクト): 受信者の情報
    • name (文字列): 受信者の名前
    • phone (文字列): 受信者の電話番号
  • content (文字列): テキストメッセージの内容
• 戻り値: メッセージ送信の確認情報（IDとステータスを含む）

sendTemplateMessage

• WhatsAppにテンプレートメッセージを送信します。
• 必要な入力:
  • recipient (オブジェクト): 受信者の情報
    • name (文字列): 受信者の名前
    • phone (文字列): 受信者の電話番号
  • templateName (文字列): 使用するテンプレートの名前
  • templateValues (オブジェクト): テンプレート内のプレースホルダーの値
• 戻り値: テンプレートメッセージ送信の確認情報（IDとステータスを含む）

sendInteractiveMessage

• WhatsAppにインタラクティブメッセージを送信します。
• 必要な入力:
  • recipient (オブジェクト): 受信者の情報
    • name (文字列): 受信者の名前
    • phone (文字列): 受信者の電話番号
  • content (文字列): インタラクティブメッセージの内容
  • buttons (配列): メッセージ内のボタンの配列
    • 各ボタンオブジェクトは以下を含む必要があります。
      • type (文字列): "reply" タイプである必要があります。
      • reply (オブジェクト): 以下を含みます。
        • id (文字列): 返信ボタンのID
        • title (文字列): 返信ボタンのタイトル
• 戻り値: インタラクティブメッセージ送信の確認情報（IDとステータスを含む）

📦 インストール

リポジトリのクローン

以下のコマンドを使用して、このリポジトリをローカルマシンにクローンします。

git clone https://github.com/yourusername/gallabox-mcp-server.git

依存関係のインストール

プロジェクトディレクトリに移動し、必要な依存関係をインストールします。

cd gallabox-mcp-server
yarn

📚 ドキュメント

Claude Desktop の設定

Gallabox MCP サーバを Claude Desktop 上で実行するには、claude_desktop_config.json ファイルを設定する必要があります。以下は設定例です。

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "/Users/navayuvan/Works/gallabox-mcp-server"],
      "env": {
        "CHANNEL_ID": "<your_channel_id>",
        "GALLABOX_API_KEY": "<your_api_key>",
        "GALLABOX_API_SECRET": "<your_api_secret>"
      }
    }
  }
}

設定が完了したら、Claude Desktop を再起動します。

設定の説明

• command: サーバを実行するコマンドで、npx を使用してローカルパッケージを実行します。
• args: コマンドに渡す引数で、Gallabox MCP サーバのパスを指定します。
• env: サーバの実行に必要な環境変数で、API 認証情報とチャネル ID を含みます。