Line Bot MCP Server

🚀 LINE Bot MCP 服務器

將 Model Context Protocol (MCP) 服務器實現與 LINE 消息 API 集成，從而把 AI 代理連接到 LINE 正式賬戶。

⚠️ 重要提示

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

🚀 快速開始

本項目將 MCP 服務器實現與 LINE 消息 API 集成，為連接 AI 代理到 LINE 正式賬戶提供解決方案。你可以通過以下步驟開始使用。

✨ 主要特性

• 提供了多種工具用於向 LINE 用戶推送不同類型的消息，包括簡單文本消息、靈活消息、圖片消息和地理位置消息。
• 支持使用 npx 和 Docker 兩種方式進行安裝和部署。
• 遵循語義化版本控制，方便版本管理。

📦 安裝指南

使用 npx

1. 克隆倉庫：

   git clone https://github.com/line/line-bot-mcp-server.git
   

2. 運行服務器：

   npm install
   node index.js
   

使用 Docker

1. 克隆倉庫：

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

2. 構建 Docker 鏡像：

   docker build -t line/line-bot-mcp-server .
   

📚 詳細文檔

工具

1. push_text_message

   • 功能：向用戶通過 LINE 推送一條簡單的文本消息。
   • 輸入：
     • user_id (string?): 收到消息的用戶 ID。默認為 DESTINATION_USER_ID。
     • message.text (string): 發送給用戶的純文本內容。

2. push_flex_message

   • 功能：向用戶通過 LINE 推送一條高度可自定義的靈活消息。
   • 輸入：
     • user_id (string?): 收到消息的用戶 ID。默認為 DESTINATION_USER_ID。
     • message.altText (string): 當無法顯示 flex 消息時顯示的備用文本。
     • message.content (any): 消息的內容。這是定義佈局和組件的 JSON 對象。
     • message.contents.type (enum): 容器類型。'bubble' 表示單個容器，'carousel' 表示多個可滑動的氣泡。

3. push_image_message

   • 功能：向用戶通過 LINE 推送一條包含圖片的消息。
   • 輸入：
     • user_id (string?): 收到消息的用戶 ID。默認為 DESTINATION_USER_ID。
     • message.imageUrl (string): 圖片的 URL 地址。

4. push_location_message

   • 功能：向用戶通過 LINE 推送一條包含地理位置的消息。
   • 輸入：
     • user_id (string?): 收到消息的用戶 ID。默認為 DESTINATION_USER_ID。
     • message.latitude (number): 地理位置的緯度。
     • message.longitude (number): 地理位置的經度。

配置 AI 代理

使用 npx

在 mcp-servers.json 中添加以下配置：

{
  "mcpServers": {
    "line-bot": {
      "command": "npx",
      "args": [
        "@line/line-bot-mcp-server"
      ],
      "env": {
        "CHANNEL_ACCESS_TOKEN": "YOUR_CHANNEL_ACCESS_TOKEN",
        "DESTINATION_USER_ID": "YOUR_DESTINATION_USER_ID"
      }
    }
  }
}

使用 Docker

在 mcp-servers.json 中添加以下配置：

{
  "mcpServers": {
    "line-bot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CHANNEL_ACCESS_TOKEN",
        "-e",
        "DESTINATION_USER_ID",
        "line/line-bot-mcp-server"
      ],
      "env": {
        "CHANNEL_ACCESS_TOKEN": "YOUR_CHANNEL_ACCESS_TOKEN",
        "DESTINATION_USER_ID": "YOUR_DESTINATION_USER_ID"
      }
    }
  }
}

🔧 技術細節

該項目遵循語義化版本控制。有關詳細信息，請訪問 semver.org。

📄 許可證

請在提交貢獻之前查閱 CONTRIBUTING.md。