Line Bot MCP Server

🚀 LINE Bot MCP Server

Integrate the Model Context Protocol (MCP) server implementation with the LINE Messaging API to connect AI agents to LINE official accounts.

⚠️ Important Note

This repository is provided as a preview version. Although we offer it for experimental purposes, please note that it may not include full functionality or comprehensive support.

✨ Features

Tools

1. push_text_message

   • Push a simple text message to a user via LINE.
   • Input:
     • user_id (string?): The ID of the user who will receive the message. Defaults to DESTINATION_USER_ID.
     • message.text (string): The plain text content to be sent to the user.

2. push_flex_message

   • Push a highly customizable flex message to a user via LINE.
   • Input:
     • user_id (string?): The ID of the user who will receive the message. Defaults to DESTINATION_USER_ID.
     • message.altText (string): The alternative text to be displayed when the flex message cannot be shown.
     • message.content (any): The content of the message. This is a JSON object that defines the layout and components.
     • message.contents.type (enum): The container type. 'bubble' represents a single container, and 'carousel' represents multiple slidable bubbles.

3. push_image_message

   • Push a message containing an image to a user via LINE.
   • Input:
     • user_id (string?): The ID of the user who will receive the message. Defaults to DESTINATION_USER_ID.
     • message.imageUrl (string): The URL address of the image.

4. push_location_message

   • Push a message containing a location to a user via LINE.
   • Input:
     • user_id (string?): The ID of the user who will receive the message. Defaults to DESTINATION_USER_ID.
     • message.latitude (number): The latitude of the location.
     • message.longitude (number): The longitude of the location.

📦 Installation

Using npx

1. Clone the repository:

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

2. Run the server:

   npm install
   node index.js
   

Using Docker

1. Clone the repository:

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

2. Build the Docker image:

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

📚 Documentation

Configuring AI Agents

Using npx

Add the following configuration to 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"
      }
    }
  }
}

Using Docker

Add the following configuration to 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"
      }
    }
  }
}

Version Control

This project follows semantic versioning.

For more details, please visit semver.org.

Contribution

Please refer to CONTRIBUTING.md before submitting contributions.