使用说明

项目简介

LINE Bot MCP Server 是一个 MCP 服务器的实现，它允许 AI Agent 通过 Model Context Protocol 与 LINE 官方账号进行交互。该服务器提供了一系列工具，使 AI Agent 能够向 LINE 用户发送消息（文本和 Flex Message），并获取用户的基本信息。

主要功能点

消息推送 (push_text_message, push_flex_message): 允许 AI Agent 向指定的 LINE 用户推送文本消息或更丰富的 Flex Message 消息，用于主动向用户发送通知、回复或推广信息。Flex Message 支持更灵活和美观的消息布局，可以包含图片、按钮、轮播图等元素。
用户信息查询 (get_profile): 允许 AI Agent 获取 LINE 用户的个人资料信息，包括显示名称、头像 URL、状态消息和语言设置，有助于 AI Agent 更好地理解用户身份和偏好。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js v20 或更高版本。

克隆仓库: 使用 Git 克隆 'line-bot-mcp-server' 仓库到本地。

git clone [email protected]/line/line-bot-mcp-server.git
cd line-bot-mcp-server

安装依赖并构建 (如果使用 Node.js): 如果你计划使用 Node.js 运行服务器，请执行以下命令安装依赖并构建项目。如果使用 Docker，则可以跳过此步骤。
```
npm install
npm run build
```
获取 Channel Access Token 和 User ID:
- 访问 LINE Developers Console 创建或登录你的 LINE 官方账号。
- 获取 Channel Access Token，用于服务器验证你的 LINE 官方账号。
- 获取接收消息的用户的 User ID (Destination User ID)，用于测试消息推送功能。

服务器配置

要将 LINE Bot MCP Server 连接到 MCP 客户端（如 Claude），你需要在 MCP 客户端的配置中添加以下服务器信息。你需要根据你的运行方式（Node.js 或 Docker）选择相应的配置，并替换 'FILL_HERE' 为你实际的 'CHANNEL_ACCESS_TOKEN' 和 'DESTINATION_USER_ID'，以及 'PATH/TO/line-bot-mcp-server' 为你的本地仓库路径（如果使用 Node.js 方式）。

Option 1: 使用 Node.js 运行

{
  "mcpServers": {
    "line-bot": {  // 服务器名称，可以自定义
      "command": "node",  // 运行命令，指定使用 node 解释器
      "args": [
        "PATH/TO/line-bot-mcp-server/dist/index.js" //  服务器入口文件路径，请替换为实际路径
      ],
      "env": {
        "CHANNEL_ACCESS_TOKEN" : "FILL_HERE",  //  LINE 官方账号的 Channel Access Token，请替换为实际 Token
        "DESTINATION_USER_ID" : "FILL_HERE"   //  接收消息的 LINE User ID，用于测试，请替换为实际 User ID
      }
    }
  }
}

Option 2: 使用 Docker 运行

首先，构建 Docker 镜像：

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

然后，在 MCP 客户端配置中使用 Docker 运行：

{
  "mcpServers": {
    "line-bot": {  // 服务器名称，可以自定义
      "command": "docker", // 运行命令，指定使用 docker
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CHANNEL_ACCESS_TOKEN",
        "-e",
        "DESTINATION_USER_ID",
        "line/line-bot-mcp-server" // Docker 镜像名称
      ],
      "env": {
        "CHANNEL_ACCESS_TOKEN" : "FILL_HERE",  //  LINE 官方账号的 Channel Access Token，请替换为实际 Token
        "DESTINATION_USER_ID" : "FILL_HERE"   //  接收消息的 LINE User ID，用于测试，请替换为实际 User ID
      }
    }
  }
}

基本使用方法

配置完成后，MCP 客户端应该能够检测到 'line-bot' 服务器及其提供的工具。你可以指示 AI Agent 使用这些工具来与 LINE 用户互动。例如：

指示 AI Agent 使用 'push_text_message' 工具向指定用户发送文本消息。
指示 AI Agent 使用 'push_flex_message' 工具发送更丰富的消息内容，例如创建包含按钮或图片的交互式消息。
指示 AI Agent 使用 'get_profile' 工具获取用户的基本信息，以便更好地理解用户。

注意: 请务必妥善保管你的 'CHANNEL_ACCESS_TOKEN'，避免泄露。'DESTINATION_USER_ID' 用于测试，实际应用中可能需要动态获取用户 ID。

关键词