AI导哈

LINE Bot消息服务器

一个实现Model Context Protocol (MCP)的服务器，集成LINE Messaging API，用于连接AI代理与LINE官方账号，支持文本和富媒体消息推送、用户信息获取等功能。

  • by tndfame
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 tndfame/mcp_management

使用说明

日语版README请点击此处

LINE Bot MCP 服务器

模型上下文协议（MCP） 集成了LINE Messaging API的服务器实现，用于将AI Agent连接到LINE官方账号。

[!NOTE]（注：此标记通常用于指示以下内容为注意事项或提示） 此仓库提供的是预览版本。虽然我们提供它供实验使用，但请注意，它可能不包含完整功能或全面支持。

工具

  1. 推送文本消息
    • 通过LINE向用户推送一条简单文本消息。
    • 输入：
      • user_id (字符串?): 接收消息的用户ID。默认为DESTINATION_USER_ID。可以是 user_id 或者 DESTINATION_USER_ID 必须设置。
      • message.text (字符串)：要发送给用户的基本文本内容。
  2. 推送灵活消息
    • 通过LINE向用户推送高度可定制的Flex消息。
    • 输入：
      • user_id (string?): 接收消息的用户ID。默认为DESTINATION_USER_ID。可以是 user_id 或者 DESTINATION_USER_ID 必须设定。
      • message.altText （字符串）：当弹性消息无法显示时显示的替代文本。
      • message.content (任意): 灵活消息的内容。这是一个JSON对象，用于定义消息的布局和组件。
      • message.contents.type (enum): 容器的类型。'bubble' 表示单个容器，'carousel' 表示多个可滑动的气泡容器。
  3. 广播文本信息
    • 通过LINE向所有关注了您的LINE官方账号的用户发送一条简单的文本消息。
    • 输入：
      • message.text (字符串)：要发送给用户的明文内容。
  4. 广播灵活消息
    • 通过LINE向所有已添加您LINE官方账号的用户广播一条高度可定制的Flex消息。
    • 输入：
      • message.altText （字符串）：当弹性消息无法显示时显示的替代文本。
      • message.content (any): 灵活消息的内容。这是一个JSON对象，用于定义消息的布局和组件。
      • message.contents.type (枚举): 容器的类型。'bubble' 表示单个容器，'carousel' 表示多个可滑动的气泡（容器）。
  5. 获取个人资料
    • 获取LINE用户的详细资料信息，包括显示名称、头像URL、状态信息和语言。
    • 输入：
      • user_id （字符串？）：您想要检索其个人资料的用户的ID。默认值为DESTINATION_USER_ID。
  6. 获取消息配额
    • 获取LINE官方账号的消息配额及使用情况。这将显示每月的消息限制和当前使用量。
    • 输入：
      • 无
  7. 获取富菜单列表
    • 获取与您的LINE官方账号关联的丰富菜单列表。
    • 输入：
      • 无
  8. 删除富文本菜单
    • 从您的LINE官方账号中删除一个富媒体菜单。
    • 输入：
      • richMenuId (字符串)：要删除的富菜单的ID。
  9. 设置默认富菜单
    • 将一个丰富的菜单设置为默认的丰富菜单。
    • 输入：
      • richMenuId (字符串)：要设置为默认的富菜单的ID。
  10. 取消默认富菜单
    • 取消默认的富菜单。
    • 输入：
      • 无

安装（使用 npx）

要求：

  • Node.js 20版或更高版本

第一步：创建LINE官方账号

这个MCP服务器使用了一个LINE官方账号。如果您还没有一个，请按照以下步骤创建 这份说明书.

如果您拥有LINE官方账号，请按照以下步骤为您的LINE官方账号启用消息API 这个说明书。

步骤2：配置AI代理

请为像Claude Desktop或Cline这样的AI代理添加以下配置。

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

  • CHANNEL_ACCESS_TOKEN（必需）频道访问令牌。您可以通过以下步骤确认： 这个说明书。
  • DESTINATION_USER_ID（可选）收件人的默认用户ID。如果工具的输入中未包含 user_id， 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。如果工具的输入中不包含 user_id， 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"
      }
    }
  }
}

使用检查器进行本地开发

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

先决条件

  1. 克隆仓库：
git clone git@github.com:line/line-bot-mcp-server.git
cd line-bot-mcp-server
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

运行检查器

项目构建完成后，您可以启动MCP Inspector：

npx @modelcontextprotocol/inspector node dist/index.js

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

版本控制

这个项目遵循语义化版本控制

请参阅 http://semver.org/

做出贡献

请检查 贡献指南（或：如何参与贡献） 在做出贡献之前。

相关 MCP