适合谁
- 已拥有 LINE 官方账号并启用 Messaging API 的开发者或运营团队
- 希望用 AI Agent 自动完成 LINE 消息推送与账号运营的团队
- 使用 Claude Desktop、Cline 等支持 MCP 的客户端并需要接入 LINE 的场景
L
61FMRS · C
LINE Bot MCP Server 由 LINE 官方维护，是其 Messaging API 与 MCP 的集成实现；它提供消息推送与群发、用户资料、消息配额、富菜单管理和好友 ID 获取共 12 个工具，仓库明确标注为预览版。适合已有 LINE 官方账号并希望让 AI Agent 执行消息推送与账号运营的用户；使用前需妥善保管 Channel Access Token，并注意广播与富菜单增删操作会直接影响线上账号。
LINE Bot MCP Server 是 LINE 官方提供的 Model Context Protocol 服务器实现，通过 LINE Messaging API 把 AI Agent 连接到 LINE 官方账号（LINE Official Account）。它提供消息推送与群发、用户资料查询、消息配额查询、富菜单（Rich Menu）管理以及好友用户 ID 获取等能力。仓库说明中标注该版本为预览版（preview version），仅用于实验目的，可能功能不完整或不提供全面支持。
工具能力
push_text_message
向指定 LINE 用户推送一条纯文本消息。
push_flex_message
向指定 LINE 用户推送一条可高度自定义的 Flex 消息。
broadcast_text_message
向所有已关注该 LINE 官方账号的用户群发一条纯文本消息。
broadcast_flex_message
向所有已添加该 LINE 官方账号的用户群发一条可高度自定义的 Flex 消息。
get_profile
获取 LINE 用户的详细资料，包括显示名称、头像 URL、状态消息和语言。
get_message_quota
获取 LINE 官方账号的消息配额与已使用量，即每月消息上限与当前用量。
get_rich_menu_list
获取与该 LINE 官方账号关联的富菜单列表。
delete_rich_menu
删除该 LINE 官方账号下的某个富菜单。
set_rich_menu_default
将某个富菜单设置为默认富菜单。
cancel_rich_menu_default
取消默认富菜单。
create_rich_menu
根据给定动作创建富菜单：生成并上传图片，并设置为默认富菜单。
get_follower_ids
获取已将该 LINE 官方账号添加为好友的用户 ID 列表，便于直接获得可发送消息的用户 ID。
安装接入
- 准备 LINE 官方账号：若尚无账号，请按 LINE 官方文档创建；若已有账号，请在 LINE Official Account Manager 中启用 Messaging API。
- 使用 npx 方式（要求 Node.js v22 或更高版本）：在 Claude Desktop 或 Cline 等 AI Agent 的配置中加入 mcpServers 配置，command 为 npx，args 为 @line/line-bot-mcp-server，并在 env 中设置 NPM_CONFIG_IGNORE_SCRIPTS 为 true、CHANNEL_ACCESS_TOKEN（必填）与 DESTINATION_USER_ID（可选，当工具输入未包含 userId 时必填）。
- 使用 Docker 方式：克隆仓库后执行 docker build -t line/line-bot-mcp-server . 构建镜像，再配置 command 为 docker，args 为 run -i --rm -e CHANNEL_ACCESS_TOKEN -e DESTINATION_USER_ID line/line-bot-mcp-server，并在 env 中填入 CHANNEL_ACCESS_TOKEN 与 DESTINATION_USER_ID。
- 本地开发调试：克隆仓库并进入目录，执行 npm install 与 npm run build，然后运行 npx @modelcontextprotocol/inspector node dist/index.js -e CHANNEL_ACCESS_TOKEN="..." -e DESTINATION_USER_ID="..." 启动 MCP Inspector 进行测试。
- 注意：CHANNEL_ACCESS_TOKEN 可通过 LINE 文档中的长期 Channel Access Token 说明获取；DESTINATION_USER_ID 可通过获取用户 ID 的说明获取。
claude_desktop_config.json
{
"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"
}
}
}
}
选型与风险
不适合谁
- 没有 LINE 官方账号或未启用 Messaging API 的用户的用户
- 需要超出预览版能力与支持范围的稳定生产级依赖的场景
- Node.js 版本低于 v22 且无法使用 Docker 的环境
所需权限
- 需要 CHANNEL_ACCESS_TOKEN（Channel Access Token）以调用 LINE Messaging API
- 可选需要 DESTINATION_USER_ID 作为默认接收者
- 需要能够访问 LINE Messaging API 的网络权限
风险与副作用
- CHANNEL_ACCESS_TOKEN 属于敏感凭据，泄露后他人可代表官方账号发送消息或读取资料
- 广播消息会发送给所有好友，误用可能造成骚扰或不可撤回的群发影响
- create_rich_menu、delete_rich_menu、set_rich_menu_default 等操作会直接改动官方账号的富菜单配置
- 该仓库为预览版，可能功能不完整或不提供全面支持
常见排障
- 确认 Node.js 版本为 v22 或更高版本
- 确认 CHANNEL_ACCESS_TOKEN 已正确设置；若工具输入未提供 userId，请同时设置 DESTINATION_USER_ID
- 使用 npx 时确认 env 中已设置 NPM_CONFIG_IGNORE_SCRIPTS 为 true
- 使用 Docker 时确认镜像已通过 docker build 构建且容器参数正确传入环境变量
- 本地调试可先执行 npm run build，再用 MCP Inspector 加载 dist/index.js 检查工具是否可用
使用场景
让 AI Agent 代表官方账号向指定用户推送文本或 Flex 消息
向全部好友群发通知、公告或营销消息
查询用户资料以做个性化回复
查看官方账号的月度消息配额与已用量
创建、设置默认或删除富菜单以管理聊天界面入口
批量获取好友用户 ID，用于后续消息发送
支持客户端
Claude Desktop完整支持
Cline完整支持