线机器人MCP服务器

Name: 线机器人MCP服务器
Author: line

作者：line496 星标更新：2025-11-21

安装使用来源：spider==github.com

项目介绍

【技术文档摘要】：日语版 README请点击这里

LINE Bot MCP Server

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

[!NOTE] 本仓库提供预览版本。虽然我们提供实验用途，但请注意它可能不包括完整的功能或全面的支持。

工具

push_text_message
- 通过LINE向用户推送简单的文本消息。
- 输入参数：
  - userId (string?)：接收消息的用户ID。默认为DESTINATION_USER_ID。必须设置userId或DESTINATION_USER_ID之一。
  - message.text (string)：要发送给用户的纯文本内容。
push_flex_message
- 通过LINE向用户推送高度可定制的flex消息。
- 输入参数：
  - userId (string?)：接收消息的用户ID。默认为DESTINATION_USER_ID。必须设置userId或DESTINATION_USER_ID之一。
  - message.altText (string)：当flex消息无法显示时显示的替代文本。
  - message.contents (any)：flex消息的内容。这是一个定义消息布局和组件的JSON对象。
  - message.contents.type (枚举)：容器类型。'bubble'表示单个容器，'carousel'表示多个可滑动的气泡。
broadcast_text_message
- 通过LINE向所有已关注您LINE官方账号的用户广播简单的文本消息。
- 输入参数：
  - message.text (string)：要发送给用户的纯文本内容。
broadcast_flex_message
- 通过LINE向所有已添加您LINE官方账号的用户广播高度可定制的flex消息。
- 输入参数：
  - message.altText (string)：当flex消息无法显示时显示的替代文本。
  - message.contents (any)：flex消息的内容。这是一个定义消息布局和组件的JSON对象。
  - message.contents.type (枚举)：容器类型。'bubble'表示单个容器，'carousel'表示多个可滑动的气泡。
get_profile
- 获取LINE用户的详细资料信息，包括显示名称、个人头像URL、状态消息和语言。
- 输入参数：
  - userId (string?)：要检索其资料的用户的ID。默认为DESTINATION_USER_ID。
get_message_quota
- 获取LINE官方账号的消息配额和消耗情况。这显示了每月消息限制和当前使用量。
- 输入参数：
  - 无
get_rich_menu_list
- 获取与您的LINE官方账号关联的富菜单列表。
- 输入参数：
  - 无
delete_rich_menu
- 从您的LINE官方账号中删除一个富菜单。
- 输入参数：
  - richMenuId (string)：要删除的富菜单的ID。
set_rich_menu_default
- 将一个富菜单设置为默认富菜单。
- 输入参数：
  - richMenuId (string)：要设置为默认的富菜单的ID。
cancel_rich_menu_default
- 取消默认富菜单。
- 输入参数：
  - 无
create_rich_menu
- 根据给定的动作创建一个富菜单。生成并上传图像。设置为默认。
- 输入参数：
  - chatBarText (string)：在聊天栏中显示的文本，也用作富菜单名称。
  - actions (数组)：富菜单的动作。您可以指定最少1个最多6个动作。每个动作可以是以下类型之一：
    - postback：用于发送postback动作
    - message：用于发送文本消息
    - uri：用于打开URL
    - datetimepicker：用于打开日期/时间选择器
    - camera：用于打开相机
    - cameraRoll：用于打开相册
    - location：用于发送当前位置
    - richmenuswitch：用于切换到另一个富菜单
    - clipboard：用于复制文本到剪贴板

安装（使用npx）

需求：

Node.js v20或更高版本

步骤1：创建LINE官方账号

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

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

步骤2：配置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": {
        "CHANNEL_ACCESS_TOKEN" : "FILL_HERE",
       _ "DESTINATION_USER_ID" : "FILL_HERE"
      }
    }
  }
}

安装（使用Docker）

步骤1：创建LINE官方账号

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

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

步骤2：构建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：（必需）频道访问令牌。您可以按照这些说明确认。
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来测试和调试服务器。

前提条件

克隆仓库：

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

安装依赖项：

npm install

构建项目：

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。