LINE Bot MCP Server

README em japonês

LINE Bot MCP Server

Implementação de servidor Model Context Protocol (MCP) que integra a LINE Messaging API para conectar um Agente de IA à Conta Oficial do LINE.

[!NOTE] Este repositório é fornecido como uma versão de pré-visualização. Embora o ofereçamos para fins experimentais, esteja ciente de que pode não incluir funcionalidades completas ou suporte abrangente.

Ferramentas

1. push_text_message
   • Envia uma mensagem de texto simples ao usuário via LINE.
   • Entradas:
     • user_id (string): O ID do usuário que receberá a mensagem. O padrão é DESTINATION_USER_ID.
     • message.text (string): O conteúdo de texto simples a ser enviado ao usuário.
2. push_flex_message
   • Envia uma mensagem flex altamente personalizável ao usuário via LINE. Suporta layouts de bolha (container único) e carrossel (múltiplas bolhas deslizáveis).
   • Entradas:
     • user_id (string): O ID do usuário que receberá a mensagem. O padrão é DESTINATION_USER_ID.
     • message.altText (string): Texto alternativo exibido quando a mensagem flex não pode ser exibida.
     • message.content (any): O conteúdo da mensagem flex. É um objeto JSON que define o layout e os componentes da mensagem.
     • message.contents.type (enum): Tipo do container. 'bubble' para container único, 'carousel' para múltiplas bolhas deslizáveis.
3. get_profile
   • Obtém informações detalhadas do perfil de um usuário LINE, incluindo nome de exibição, URL da foto de perfil, mensagem de status e idioma.
   • Entradas:
     • user_id (string): O ID do usuário cujo perfil você deseja obter. O padrão é DESTINATION_USER_ID.

Instalação

Passo 1: Instalar o line-bot-mcp-server

requisitos:

• Node.js v20 ou posterior

Clone este repositório:

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

Instale as dependências necessárias e compile o line-bot-mcp-server ao usar Node.js. Esta etapa não é necessária ao usar Docker:

cd line-bot-mcp-server && npm install && npm run build

Passo 2: Obter um token de acesso do canal

Este servidor MCP utiliza uma Conta Oficial do LINE. Se você não tiver uma, crie uma seguindo estas instruções.

Para conectar à Messaging API, você precisa de um token de acesso do canal. Você pode confirmar isso seguindo estas instruções.

Além disso, você precisará do ID do usuário destinatário das mensagens. Você pode confirmar isso seguindo estas instruções.

Passo 3: Configurar o Agente de IA

Adicione a seguinte configuração para um Agente de IA como Claude Desktop ou Cline. Insira o token de acesso do canal e o ID do usuário obtidos anteriormente em CHANNEL_ACCESS_TOKEN e DESTINATION_USER_ID, respectivamente. Além disso, atualize o caminho para line-bot-mcp-server em mcpServers.args.

Opção 1: Usar Node

{
  "mcpServers": {
    "line-bot": {
      "command": "node",
      "args": [
        "PATH/TO/line-bot-mcp-server/dist/index.js"
      ],
      "env": {
        "CHANNEL_ACCESS_TOKEN" : "FILL_HERE",
        "DESTINATION_USER_ID" : "FILL_HERE"
      }
    }
  }
}

Opção 2: Usar Docker

Construa a imagem Docker primeiro:

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

{
  "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"
      }
    }
  }
}