🚀 LINE Bot MCP 服务器

将 Model Context Protocol (MCP) 服务器实现与 LINE 消息 API 集成，从而把 AI 代理连接到 LINE 正式账户。

⚠️ 重要提示

本仓库作为预览版本提供。尽管我们作为实验用途提供它，但请注意它可能不包含完整的功能或全面的支持。

🚀 快速开始

本项目将 MCP 服务器实现与 LINE 消息 API 集成，为连接 AI 代理到 LINE 正式账户提供解决方案。你可以通过以下步骤开始使用。

✨ 主要特性

• 提供了多种工具用于向 LINE 用户推送不同类型的消息，包括简单文本消息、灵活消息、图片消息和地理位置消息。
• 支持使用 npx 和 Docker 两种方式进行安装和部署。
• 遵循语义化版本控制，方便版本管理。

📦 安装指南

使用 npx

1. 克隆仓库：

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

2. 运行服务器：

   npm install
   node index.js
   

使用 Docker

1. 克隆仓库：

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

2. 构建 Docker 镜像：

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

📚 详细文档

工具

1. push_text_message

   • 功能：向用户通过 LINE 推送一条简单的文本消息。
   • 输入：
     • user_id (string?): 收到消息的用户 ID。默认为 DESTINATION_USER_ID。
     • message.text (string): 发送给用户的纯文本内容。

2. push_flex_message

   • 功能：向用户通过 LINE 推送一条高度可自定义的灵活消息。
   • 输入：
     • user_id (string?): 收到消息的用户 ID。默认为 DESTINATION_USER_ID。
     • message.altText (string): 当无法显示 flex 消息时显示的备用文本。
     • message.content (any): 消息的内容。这是定义布局和组件的 JSON 对象。
     • message.contents.type (enum): 容器类型。'bubble' 表示单个容器，'carousel' 表示多个可滑动的气泡。

3. push_image_message

   • 功能：向用户通过 LINE 推送一条包含图片的消息。
   • 输入：
     • user_id (string?): 收到消息的用户 ID。默认为 DESTINATION_USER_ID。
     • message.imageUrl (string): 图片的 URL 地址。

4. push_location_message

   • 功能：向用户通过 LINE 推送一条包含地理位置的消息。
   • 输入：
     • user_id (string?): 收到消息的用户 ID。默认为 DESTINATION_USER_ID。
     • message.latitude (number): 地理位置的纬度。
     • message.longitude (number): 地理位置的经度。

配置 AI 代理

使用 npx

在 mcp-servers.json 中添加以下配置：

{
  "mcpServers": {
    "line-bot": {
      "command": "npx",
      "args": [
        "@line/line-bot-mcp-server"
      ],
      "env": {
        "CHANNEL_ACCESS_TOKEN": "YOUR_CHANNEL_ACCESS_TOKEN",
        "DESTINATION_USER_ID": "YOUR_DESTINATION_USER_ID"
      }
    }
  }
}

使用 Docker

在 mcp-servers.json 中添加以下配置：

{
  "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": "YOUR_CHANNEL_ACCESS_TOKEN",
        "DESTINATION_USER_ID": "YOUR_DESTINATION_USER_ID"
      }
    }
  }
}

🔧 技术细节

该项目遵循语义化版本控制。有关详细信息，请访问 semver.org。

📄 许可证

请在提交贡献之前查阅 CONTRIBUTING.md。