日文版 README はこちら

LINE Bot MCP 服务器

这是一个集成 LINE 消息 API 的 Model Context Protocol (MCP) 服务器实现，用于将 AI 助手连接到 LINE 官方账号。

[!NOTE] 此仓库目前作为预览版本提供。虽然我们将其用于实验目的，但请注意，它可能不包含完整功能或全面支持。

工具

1. push_text_message

   • 通过 LINE 向用户发送一条简单的文本消息。
   • 输入：
     • userId（字符串？）：接收消息的用户 ID。默认为 DESTINATION_USER_ID。必须设置 userId 或 DESTINATION_USER_ID 中的一个。
     • message.text（字符串）：要发送给用户的纯文本内容。

2. push_flex_message

   • 通过 LINE 向用户发送一条高度可定制的 Flex 消息。
   • 输入：
     • userId（字符串？）：接收消息的用户 ID。默认为 DESTINATION_USER_ID。必须设置 userId 或 DESTINATION_USER_ID 中的一个。
     • message.altText（字符串）：当 Flex 消息无法显示时显示的替代文本。
     • message.contents（任意）：Flex 消息的内容。这是一个定义消息布局和组件的 JSON 对象。
     • message.contents.type（枚举）：容器类型。“bubble”表示单个容器，“carousel”表示多个可滑动的气泡。

3. broadcast_text_message

   • 通过 LINE 向所有关注您 LINE 官方账号的用户广播一条简单的文本消息。
   • 输入：
     • message.text（字符串）：要发送给用户的纯文本内容。

4. broadcast_flex_message

   • 通过 LINE 向所有添加了您 LINE 官方账号的用户广播一条高度可定制的 Flex 消息。
   • 输入：
     • message.altText（字符串）：当 Flex 消息无法显示时显示的替代文本。
     • message.contents（任意）：Flex 消息的内容。这是一个定义消息布局和组件的 JSON 对象。
     • message.contents.type（枚举）：容器类型。“bubble”表示单个容器，“carousel”表示多个可滑动的气泡。

5. get_profile

   • 获取 LINE 用户的详细资料信息，包括显示名称、头像 URL、状态消息和语言。
   • 输入：
     • userId（字符串？）：要获取其个人资料的用户 ID。默认为 DESTINATION_USER_ID。

6. get_message_quota

   • 获取 LINE 官方账号的消息配额及使用情况。这会显示每月的消息限制和当前使用量。
   • 输入：
     • 无

7. get_rich_menu_list

   • 获取与您的 LINE 官方账号关联的 Rich Menu 列表。
   • 输入：
     • 无

8. delete_rich_menu

   • 从您的 LINE 官方账号中删除一个 Rich Menu。
   • 输入：
     • richMenuId（字符串）：要删除的 Rich Menu ID。

9. set_rich_menu_default

   • 将一个 Rich Menu 设置为默认 Rich Menu。
   • 输入：
     • richMenuId（字符串）：要设置为默认的 Rich Menu ID。

10. cancel_rich_menu_default

    • 取消默认的 Rich Menu。
    • 输入：
      • 无

11. create_rich_menu

    • 根据给定的操作创建一个 Rich Menu。生成并上传一张图片，然后将其设置为默认。
    • 输入：
      • chatBarText（字符串）：在聊天栏中显示的文本，也用作 Rich Menu 名称。
      • actions（数组）：Rich Menu 的操作。您可以指定最少 1 个、最多 6 个操作。每个操作可以是以下类型之一：
        • postback：用于发送回传操作。
        • message：用于发送文本消息。
        • uri：用于打开 URL。
        • datetimepicker：用于打开日期/时间选择器。
        • camera：用于打开相机。
        • cameraRoll：用于打开相册。
        • location：用于发送当前位置。
        • richmenuswitch：用于切换到另一个 Rich Menu。
        • clipboard：用于将文本复制到剪贴板。

12. get_follower_ids

    • 获取已将 LINE 官方账号添加为好友的用户 ID 列表。这样您就可以获得用户 ID 来发送消息，而无需手动准备。
    • 输入：
      • start（字符串？）：用于获取下一批用户 ID 的续订令牌。该令牌会在上一次响应的 next 属性中返回。
      • limit（数字？）：单次请求中要检索的最大用户 ID 数量。

安装（使用 npx）

要求：

• Node.js v20 或更高版本

第一步：创建 LINE 官方账号

此 MCP 服务器使用 LINE 官方账号。如果您还没有，请按照 这些说明 创建一个。

如果您已经有 LINE 官方账号，请按照 这些说明 为您的 LINE 官方账号启用 Messaging API。

第二步：配置 AI 助手

请为 Claude Desktop 或 Cline 等 AI 助手添加以下配置。

按如下方式设置环境变量或参数：

• CHANNEL_ACCESS_TOKEN：（必填）通道访问令牌。您可以按照 这些说明 进行确认。
• DESTINATION_USER_ID：（可选）收件人的默认用户 ID。如果工具的输入中未包含 userId，则需要 DESTINATION_USER_ID。您可以按照 这些说明 进行确认。

{
  "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"
      }
    }
  }
}

安装（使用 Docker）

第一步：创建 LINE 官方账号

此 MCP 服务器使用 LINE 官方账号。如果您还没有，请按照 这些说明 创建一个。

如果您已经有 LINE 官方账号，请按照 这些说明 为您的 LINE 官方账号启用 Messaging API。

第二步：构建 line-bot-mcp-server 镜像

克隆此仓库：

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

构建 Docker 镜像：

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

第3步：配置AI代理

请为Claude Desktop或Cline等AI代理添加以下配置。

按照如下方式设置环境变量或参数：

• mcpServers.args：（必填）line-bot-mcp-server的路径。
• CHANNEL_ACCESS_TOKEN：（必填）Channel Access Token。您可以通过此说明来确认。
• DESTINATION_USER_ID：（可选）默认收件人用户ID。如果工具的输入中不包含userId，则必须提供DESTINATION_USER_ID。您可以通过此说明来确认。

{
  "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"
      }
    }
  }
}

使用Inspector进行本地开发

您可以使用MCP Inspector在本地测试和调试服务器。

先决条件

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

运行Inspector

构建项目后，您可以启动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"

这将启动MCP Inspector界面，您可以在其中与LINE Bot MCP Server工具交互并测试其功能。

版本控制

本项目遵循语义化版本控制规范。

详情请参阅：http://semver.org/

贡献

请在提交贡献前查看CONTRIBUTING。

LINE Bot MCP Server 快速上手指南

LINE Bot MCP Server 是一个基于 Model Context Protocol (MCP) 的服务端实现，旨在将 AI Agent（如 Claude Desktop、Cline）与 LINE 官方账号连接，使 AI 能够直接通过 LINE 发送消息、管理菜单及获取用户信息。

注意：本项目目前为预览版本（Preview），功能可能尚未完全稳定，适用于实验性用途。

环境准备

在开始之前，请确保满足以下前置条件：

1. 系统要求：
   • Node.js v20 或更高版本（若使用 npx 方式）。
   • 或者已安装 Docker（若使用 Docker 方式）。
2. LINE 官方账号：
   • 拥有一个 LINE Official Account。
   • 已在 LINE Official Account Manager 中启用 Messaging API。
3. 关键凭证：
   • CHANNEL_ACCESS_TOKEN：长期有效的频道访问令牌（Long-lived channel access token）。
   • DESTINATION_USER_ID（可选但推荐）：默认接收消息的用户 ID。若工具调用时未指定用户 ID，则必须配置此项。

安装步骤

你可以选择使用 npx 直接运行或通过 Docker 部署。

方式一：使用 npx（推荐 Node.js 用户）

1. 确保已安装 Node.js v20+。
2. 配置你的 AI Agent（如 Claude Desktop 的配置文件 claude_desktop_config.json 或 Cline 设置），添加以下 MCP 服务器配置：

{
  "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"
      }
    }
  }
}

请将 FILL_HERE 替换为你实际的 Token 和用户 ID。

方式二：使用 Docker

1. 克隆仓库并构建镜像：

git clone git@github.com:line/line-bot-mcp-server.git
cd line-bot-mcp-server
docker build -t line/line-bot-mcp-server .

2. 配置你的 AI Agent，添加以下 MCP 服务器配置：

{
  "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"
      }
    }
  }
}

基本使用

配置完成后，重启你的 AI Agent。现在你可以在对话中直接调用 LINE 相关功能。以下是几个最简单的使用示例：

1. 发送文本消息

让 AI 向指定用户（或默认用户）发送一条简单的文本通知。

用户指令示例： “请给 userId 为 U123456789 的用户发送一条消息，内容是‘您的订单已发货’。”

若已配置 DESTINATION_USER_ID，可直接说：“发消息告诉用户‘会议时间改为下午三点’。”

AI 将调用 push_text_message 工具执行操作。

2. 发送富文本（Flex）消息

让 AI 生成并发送带有布局设计的卡片消息。

用户指令示例： “创建一个包含标题‘周末促销’和按钮‘查看详情’的 Flex 消息，发送给所有关注用户。”

AI 将调用 broadcast_flex_message 或 push_flex_message，自动构建所需的 JSON 结构。

3. 查询用户资料

获取特定 LINE 用户的昵称、头像等信息。

用户指令示例： “帮我查一下用户 U123456789 的 LINE 个人资料，包括昵称和状态消息。”

AI 将调用 get_profile 工具并返回结果。

4. 管理图文菜单（Rich Menu）

创建或切换图文菜单。

用户指令示例： “创建一个新的图文菜单，包含两个按钮：一个是‘访问官网’（链接到 https://example.com），另一个是‘联系客服’（发送消息‘帮助’）。”

AI 将调用 create_rich_menu 工具，自动生成菜单结构并设置为默认。

---

可用工具列表概览：

• 消息发送：push_text_message, push_flex_message, broadcast_text_message, broadcast_flex_message
• 信息查询：get_profile, get_message_quota, get_follower_ids, get_rich_menu_list
• 菜单管理：create_rich_menu, delete_rich_menu, set_rich_menu_default, cancel_rich_menu_default