STARWARCLOUD STARWAR.AI
返回市场
线机器人MCP服务器

线机器人MCP服务器

作者：line496 星标更新：2025-11-21
安装使用来源：spider==github.com

项目介绍

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

LINE Bot MCP Server

npmjs

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

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

工具

  1. push_text_message
    • 通过LINE向用户推送简单的文本消息。
    • 输入参数：
      • userId (string?)：接收消息的用户ID。默认为DESTINATION_USER_ID。必须设置userId或DESTINATION_USER_ID之一。
      • message.text (string)：要发送给用户的纯文本内容。
  2. 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'表示多个可滑动的气泡。
  3. broadcast_text_message
    • 通过LINE向所有已关注您LINE官方账号的用户广播简单的文本消息。
    • 输入参数：
      • message.text (string)：要发送给用户的纯文本内容。
  4. broadcast_flex_message
    • 通过LINE向所有已添加您LINE官方账号的用户广播高度可定制的flex消息。
    • 输入参数：
      • message.altText (string)：当flex消息无法显示时显示的替代文本。
      • message.contents (any)：flex消息的内容。这是一个定义消息布局和组件的JSON对象。
      • message.contents.type (枚举)：容器类型。'bubble'表示单个容器，'carousel'表示多个可滑动的气泡。
  5. get_profile
    • 获取LINE用户的详细资料信息，包括显示名称、个人头像URL、状态消息和语言。
    • 输入参数：
      • userId (string?)：要检索其资料的用户的ID。默认为DESTINATION_USER_ID。
  6. get_message_quota
    • 获取LINE官方账号的消息配额和消耗情况。这显示了每月消息限制和当前使用量。
    • 输入参数：
      • 无
  7. get_rich_menu_list
    • 获取与您的LINE官方账号关联的富菜单列表。
    • 输入参数：
      • 无
  8. delete_rich_menu
    • 从您的LINE官方账号中删除一个富菜单。
    • 输入参数：
      • richMenuId (string)：要删除的富菜单的ID。
  9. set_rich_menu_default
    • 将一个富菜单设置为默认富菜单。
    • 输入参数：
      • richMenuId (string)：要设置为默认的富菜单的ID。
  10. cancel_rich_menu_default
    • 取消默认富菜单。
    • 输入参数：
      • 无
  11. 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来测试和调试服务器。

前提条件

  1. 克隆仓库：
git clone git@github.com:line/line-bot-mcp-server.git
cd line-bot-mcp-server
  1. 安装依赖项：
npm install
  1. 构建项目：
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。