Gallabox MCP Server

🚀 Gallabox MCP 服務器

Gallabox MCP（消息通信協議）服務器基於 Gallabox API 構建，可實現與 WhatsApp 進行消息交互的功能，為用戶提供便捷的消息發送服務。

✨ 主要特性

本服務器提供了一系列工具，用於向 WhatsApp 發送不同類型的消息，具體如下：

1. sendTextMessage

   • 功能：發送一條文本消息到 WhatsApp。
   • 所需輸入：
     • recipient（對象）：收件人的信息，包含：
       • name（字符串）：收件人姓名。
       • phone（字符串）：收件人電話號碼。
     • content（字符串）：文本消息的內容。
   • 返回值：消息發送確認，包括 ID 和狀態。

2. sendTemplateMessage

   • 功能：發送一條模板消息到 WhatsApp。
   • 所需輸入：
     • recipient（對象）：收件人的信息，包含：
       • name（字符串）：收件人姓名。
       • phone（字符串）：收件人電話號碼。
     • templateName（字符串）：要使用的模板名稱。
     • templateValues（對象）：模板中的佔位符值。
   • 返回值：模板消息發送確認，包括 ID 和狀態。

3. sendInteractiveMessage

   • 功能：發送一條交互式消息到 WhatsApp。
   • 所需輸入：
     • recipient（對象）：收件人的信息，包含：
       • name（字符串）：收件人姓名。
       • phone（字符串）：收件人電話號碼。
     • content（字符串）：交互式消息的內容。
     • buttons（數組）：消息中的按鈕數組，每個按鈕對象必須包含：
       • type（字符串）：應該是 "reply" 類型。
       • reply（對象）：包含：
         • id（字符串）：回覆按鈕的 ID。
         • title（字符串）：回覆按鈕的標題。
   • 返回值：交互式消息發送確認，包括 ID 和狀態。

📦 安裝指南

1. 克隆倉庫：
   使用以下命令將此倉庫克隆到本地機器：

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

2. 安裝依賴項：
   切換到項目目錄並安裝所需依賴項：

   cd gallabox-mcp-server
   yarn
   

📚 詳細文檔

Claude Desktop 配置

要在 Claude Desktop 上運行 Gallabox MCP 服務器，需要配置 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。