Line MCP Demo

🚀 LINE Bot MCP Server

這是一個 模型上下文協議 (MCP) 服務器實現，它整合了 LINE 消息 API，可將 AI 代理連接到 LINE 正式賬戶。

⚠️ 重要提示

此倉庫作為預覽版本提供。雖然我們為此實驗提供了支持，但請注意它可能不包含完整的功能或全面的支持。

✨ 主要特性

本項目提供了一系列實用工具，用於與 LINE 平臺進行交互，具體如下：

1. push_text_message

   • 功能：通過 LINE 推送簡單的文本消息給用戶。
   • 輸入參數：
     • user_id (字符串)：收到消息的用戶 ID，默認為 DESTINATION_USER_ID。
     • message.text (字符串)：發送給用戶的純文本內容。

2. push_flex_message

   • 功能：推送高度可定製的 Flex 消息給用戶，支持單容器（氣泡）和多容器（可滑動氣泡）佈局。
   • 輸入參數：
     • user_id (字符串)：收到消息的用戶 ID，默認為 DESTINATION_USER_ID。
     • message.altText (字符串)：當 Flex 消息無法顯示時顯示的備用文本。
     • message.content (任何類型)：Flex 消息的內容，是定義佈局和組件的 JSON 對象。
     • message.contents.type (枚舉)：容器類型，'bubble' 表示單容器，'carousel' 表示多滑動氣泡。

3. get_profile

   • 功能：獲取 LINE 用戶的詳細資料信息，包括顯示名稱、個人頭像 URL、狀態消息和語言。
   • 輸入參數：
     • user_id (字符串)：要檢索其資料的用戶 ID，默認為 DESTINATION_USER_ID。

📦 安裝指南

步驟 1: 安裝 line-bot-mcp-server

要求：

• Node.js v20 或更高版本

克隆此倉庫：

git clone git@github.com/line/line-bot-mcp-server.git

安裝必要的依賴項並在使用 Node.js 時構建 line-bot-mcp-server。此步驟在使用 Docker 時不需要：

cd line-bot-mcp-server && npm install && npm run build

步驟 2: 獲取通道訪問令牌

此 MCP 服務器使用 LINE 正式賬戶。如果您沒有正式賬戶，請按照 這些說明 創建。

要連接到消息 API，您需要一個通道訪問令牌。請按照 這些說明 確認此令牌。

此外，您還需要收件人用戶的消息 ID。請按照 這些說明 確認此 ID。

步驟 3: 配置 AI 代理

請為像 Claude Desktop 或 Cline 這樣的 AI 代理添加以下配置。將之前獲得的通道訪問令牌和用戶 ID 插入到 CHANNEL_ACCESS_TOKEN 和 DESTINATION_USER_ID 中，分別更新 mcpServers.args 中的 line-bot-mcp-server 路徑。

選項 1: 使用 Node

{
  "mcpServers": {
    "line-bot": {
      "command": "node",
      "args": [
        "PATH/TO/YOUR/CODE"
      ]
    }
  }
}

選項 2: 使用 Docker

{
  "mcpServers": {
    "line-bot": {
      "command": "docker",
      "args": [
        "run",
        "-it",
        "your-docker-image"
      ]
    }
  }
}

完成上述步驟後，您應該能夠成功配置並運行 LINE Bot MCP Server。