LINE Official Account MCP Server

chính thức

Tích hợp LINE Messaging API để kết nối AI Agent với LINE Official Account.

Tài liệu

LINE Bot MCP Server

Triển khai máy chủ Model Context Protocol (MCP) tích hợp LINE Messaging API để kết nối AI Agent với LINE Official Account.

[!NOTE] Kho lưu trữ này được cung cấp dưới dạng phiên bản xem trước. Mặc dù chúng tôi cung cấp cho mục đích thử nghiệm, xin lưu ý rằng nó có thể không bao gồm đầy đủ chức năng hoặc hỗ trợ toàn diện.

Công cụ

push_text_message
- Đẩy một tin nhắn văn bản đơn giản đến người dùng qua LINE.
- Đầu vào:
  - userId (string?): ID người dùng sẽ nhận tin nhắn. Mặc định là DESTINATION_USER_ID. Phải đặt userId hoặc DESTINATION_USER_ID.
  - message.text (string): Nội dung văn bản thuần túy để gửi cho người dùng.
push_flex_message
- Đẩy một tin nhắn flex có khả năng tùy chỉnh cao đến người dùng qua LINE.
- Đầu vào:
  - userId (string?): ID người dùng sẽ nhận tin nhắn. Mặc định là DESTINATION_USER_ID. Phải đặt userId hoặc DESTINATION_USER_ID.
  - message.altText (string): Văn bản thay thế hiển thị khi không thể hiển thị tin nhắn flex.
  - message.contents (any): Nội dung của tin nhắn flex. Đây là một đối tượng JSON xác định bố cục và các thành phần của tin nhắn.
  - message.contents.type (enum): Loại container. 'bubble' cho container đơn, 'carousel' cho nhiều bubble có thể vuốt.
broadcast_text_message
- Phát sóng một tin nhắn văn bản đơn giản qua LINE đến tất cả người dùng đã theo dõi LINE Official Account của bạn.
- Đầu vào:
  - message.text (string): Nội dung văn bản thuần túy để gửi cho người dùng.
broadcast_flex_message
- Phát sóng một tin nhắn flex có khả năng tùy chỉnh cao qua LINE đến tất cả người dùng đã thêm LINE Official Account của bạn.
- Đầu vào:
  - message.altText (string): Văn bản thay thế hiển thị khi không thể hiển thị tin nhắn flex.
  - message.contents (any): Nội dung của tin nhắn flex. Đây là một đối tượng JSON xác định bố cục và các thành phần của tin nhắn.
  - message.contents.type (enum): Loại container. 'bubble' cho container đơn, 'carousel' cho nhiều bubble có thể vuốt.
get_profile
- Lấy thông tin hồ sơ chi tiết của người dùng LINE bao gồm tên hiển thị, URL ảnh đại diện, tin nhắn trạng thái và ngôn ngữ.
- Đầu vào:
  - userId (string?): ID của người dùng bạn muốn truy xuất hồ sơ. Mặc định là DESTINATION_USER_ID.
get_message_quota
- Lấy hạn ngạch và mức tiêu thụ tin nhắn của LINE Official Account. Hiển thị giới hạn tin nhắn hàng tháng và mức sử dụng hiện tại.
- Đầu vào:
  - Không có
get_rich_menu_list
- Lấy danh sách rich menu được liên kết với LINE Official Account của bạn.
- Đầu vào:
  - Không có
delete_rich_menu
- Xóa một rich menu khỏi LINE Official Account của bạn.
- Đầu vào:
  - richMenuId (string): ID của rich menu cần xóa.
set_rich_menu_default
- Đặt một rich menu làm rich menu mặc định.
- Đầu vào:
  - richMenuId (string): ID của rich menu cần đặt làm mặc định.
cancel_rich_menu_default
- Hủy rich menu mặc định.
- Đầu vào:
  - Không có
create_rich_menu
- Tạo một rich menu dựa trên các hành động đã cho. Tạo và tải lên một hình ảnh. Đặt làm mặc định.
- Đầu vào:
  - chatBarText (string): Văn bản hiển thị trong thanh trò chuyện, cũng được dùng làm tên rich menu.
  - actions (array): Các hành động của rich menu. Bạn có thể chỉ định tối thiểu 1 đến tối đa 6 hành động. Mỗi hành động có thể là một trong các loại sau:
    - postback: Để gửi một hành động postback
    - message: Để gửi một tin nhắn văn bản
    - uri: Để mở một URL
    - datetimepicker: Để mở bộ chọn ngày/giờ
    - camera: Để mở máy ảnh
    - cameraRoll: Để mở thư viện ảnh
    - location: Để gửi vị trí hiện tại
    - richmenuswitch: Để chuyển sang rich menu khác
    - clipboard: Để sao chép văn bản vào clipboard
get_follower_ids
- Lấy danh sách ID người dùng đã thêm LINE Official Account làm bạn bè. Điều này cho phép bạn lấy ID người dùng để gửi tin nhắn mà không cần chuẩn bị thủ công.
- Đầu vào:
  - start (string?): Token tiếp tục để lấy mảng ID người dùng tiếp theo. Được trả về trong thuộc tính next của phản hồi trước đó.
  - limit (number?): Số lượng ID người dùng tối đa cần truy xuất trong một yêu cầu.

Cài đặt (Sử dụng npx)

yêu cầu:

Node.js v22 trở lên

Bước 1: Tạo LINE Official Account

Máy chủ MCP này sử dụng LINE Official Account. Nếu bạn chưa có, vui lòng tạo bằng cách làm theo hướng dẫn này.

Nếu bạn đã có LINE Official Account, hãy bật Messaging API cho LINE Official Account của bạn bằng cách làm theo hướng dẫn này.

Bước 2: Cấu hình AI Agent

Vui lòng thêm cấu hình sau cho AI Agent như Claude Desktop hoặc Cline.

Đặt các biến môi trường hoặc đối số như sau:

CHANNEL_ACCESS_TOKEN: (bắt buộc) Channel Access Token. Bạn có thể xác nhận bằng cách làm theo hướng dẫn này.
DESTINATION_USER_ID: (tùy chọn) ID người dùng mặc định của người nhận. Nếu đầu vào của Công cụ không bao gồm userId, thì DESTINATION_USER_ID là bắt buộc. Bạn có thể xác nhận bằng cách làm theo hướng dẫn này.

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

Cài đặt (Sử dụng Docker)

Bước 1: Tạo LINE Official Account

Máy chủ MCP này sử dụng LINE Official Account. Nếu bạn chưa có, vui lòng tạo bằng cách làm theo hướng dẫn này.

Nếu bạn đã có LINE Official Account, hãy bật Messaging API cho LINE Official Account của bạn bằng cách làm theo hướng dẫn này.

Bước 2: Xây dựng image line-bot-mcp-server

Sao chép kho lưu trữ này:

git clone [email protected]:line/line-bot-mcp-server.git

Xây dựng Docker image:

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

Bước 3: Cấu hình AI Agent

Vui lòng thêm cấu hình sau cho AI Agent như Claude Desktop hoặc Cline.

Đặt các biến môi trường hoặc đối số như sau:

mcpServers.args: (bắt buộc) Đường dẫn đến line-bot-mcp-server.
CHANNEL_ACCESS_TOKEN: (bắt buộc) Channel Access Token. Bạn có thể xác nhận bằng cách làm theo hướng dẫn này.
DESTINATION_USER_ID: (tùy chọn) ID người dùng mặc định của người nhận. Nếu đầu vào của Công cụ không bao gồm userId, thì DESTINATION_USER_ID là bắt buộc. Bạn có thể xác nhận bằng cách làm theo hướng dẫn này.

{
  "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" : "FILL_HERE",
        "DESTINATION_USER_ID" : "FILL_HERE"
      }
    }
  }
}

Phát triển cục bộ với Inspector

Bạn có thể sử dụng MCP Inspector để kiểm tra và gỡ lỗi máy chủ cục bộ.

Điều kiện tiên quyết

Sao chép kho lưu trữ:

git clone [email protected]:line/line-bot-mcp-server.git
cd line-bot-mcp-server

Cài đặt các phụ thuộc:

npm install

Xây dựng dự án:

npm run build

Chạy Inspector

Sau khi xây dựng dự án, bạn có thể khởi động MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js \
  -e CHANNEL_ACCESS_TOKEN="YOUR_CHANNEL_ACCESS_TOKEN" \
  -e DESTINATION_USER_ID="YOUR_DESTINATION_USER_ID"

Thao tác này sẽ khởi động giao diện MCP Inspector, nơi bạn có thể tương tác với các công cụ của LINE Bot MCP Server và kiểm tra chức năng của chúng.

Phiên bản

Dự án này tuân thủ semantic versioning

Xem http://semver.org/

Đóng góp

Vui lòng kiểm tra CONTRIBUTING trước khi đóng góp.