LINE Official Account MCP Server

offiziell

Integriert die LINE Messaging API, um einen KI-Agenten mit dem LINE Official Account zu verbinden.

Dokumentation

LINE Bot MCP Server

Model Context Protocol (MCP) Server-Implementierung, die die LINE Messaging API integriert, um einen KI-Agenten mit dem LINE Official Account zu verbinden.

[!NOTE] Dieses Repository wird als Vorschauversion bereitgestellt. Wir bieten es zu experimentellen Zwecken an, beachten Sie jedoch, dass es möglicherweise nicht die vollständige Funktionalität oder umfassenden Support enthält.

Tools

push_text_message
- Sendet eine einfache Textnachricht über LINE an einen Benutzer.
- Eingaben:
  - userId (string?): Die Benutzer-ID, die die Nachricht erhalten soll. Standardmäßig DESTINATION_USER_ID. Entweder userId oder DESTINATION_USER_ID muss gesetzt sein.
  - message.text (string): Der reine Textinhalt, der an den Benutzer gesendet werden soll.
push_flex_message
- Sendet eine hochgradig anpassbare Flex-Nachricht über LINE an einen Benutzer.
- Eingaben:
  - userId (string?): Die Benutzer-ID, die die Nachricht erhalten soll. Standardmäßig DESTINATION_USER_ID. Entweder userId oder DESTINATION_USER_ID muss gesetzt sein.
  - message.altText (string): Alternativtext, der angezeigt wird, wenn die Flex-Nachricht nicht dargestellt werden kann.
  - message.contents (any): Der Inhalt der Flex-Nachricht. Dies ist ein JSON-Objekt, das das Layout und die Komponenten der Nachricht definiert.
  - message.contents.type (enum): Typ des Containers. 'bubble' für einen einzelnen Container, 'carousel' für mehrere durchblätterbare Bubbles.
broadcast_text_message
- Sendet eine einfache Textnachricht über LINE an alle Benutzer, die Ihrem LINE Official Account gefolgt sind.
- Eingaben:
  - message.text (string): Der reine Textinhalt, der an die Benutzer gesendet werden soll.
broadcast_flex_message
- Sendet eine hochgradig anpassbare Flex-Nachricht über LINE an alle Benutzer, die Ihren LINE Official Account hinzugefügt haben.
- Eingaben:
  - message.altText (string): Alternativtext, der angezeigt wird, wenn die Flex-Nachricht nicht dargestellt werden kann.
  - message.contents (any): Der Inhalt der Flex-Nachricht. Dies ist ein JSON-Objekt, das das Layout und die Komponenten der Nachricht definiert.
  - message.contents.type (enum): Typ des Containers. 'bubble' für einen einzelnen Container, 'carousel' für mehrere durchblätterbare Bubbles.
get_profile
- Ruft detaillierte Profilinformationen eines LINE-Benutzers ab, einschließlich Anzeigename, Profilbild-URL, Statusmeldung und Sprache.
- Eingaben:
  - userId (string?): Die ID des Benutzers, dessen Profil Sie abrufen möchten. Standardmäßig DESTINATION_USER_ID.
get_message_quota
- Ruft das Nachrichtenkontingent und den Verbrauch des LINE Official Account ab. Dies zeigt das monatliche Nachrichtenlimit und die aktuelle Nutzung an.
- Eingaben:
  - Keine
get_rich_menu_list
- Ruft die Liste der Rich Menus ab, die mit Ihrem LINE Official Account verknüpft sind.
- Eingaben:
  - Keine
delete_rich_menu
- Löscht ein Rich Menu aus Ihrem LINE Official Account.
- Eingaben:
  - richMenuId (string): Die ID des zu löschenden Rich Menu.
set_rich_menu_default
- Legt ein Rich Menu als Standard-Rich-Menu fest.
- Eingaben:
  - richMenuId (string): Die ID des Rich Menu, das als Standard festgelegt werden soll.
cancel_rich_menu_default
- Hebt das Standard-Rich-Menu auf.
- Eingaben:
  - Keine
create_rich_menu
- Erstellt ein Rich Menu basierend auf den angegebenen Aktionen. Generiert und lädt ein Bild hoch. Legt es als Standard fest.
- Eingaben:
  - chatBarText (string): Text, der in der Chat-Leiste angezeigt wird, wird auch als Rich-Menu-Name verwendet.
  - actions (array): Die Aktionen des Rich Menu. Sie können mindestens 1 bis maximal 6 Aktionen angeben. Jede Aktion kann einer der folgenden Typen sein:
    - postback: Zum Senden einer Postback-Aktion
    - message: Zum Senden einer Textnachricht
    - uri: Zum Öffnen einer URL
    - datetimepicker: Zum Öffnen einer Datums-/Uhrzeitauswahl
    - camera: Zum Öffnen der Kamera
    - cameraRoll: Zum Öffnen der Kamerarolle
    - location: Zum Senden des aktuellen Standorts
    - richmenuswitch: Zum Wechseln zu einem anderen Rich Menu
    - clipboard: Zum Kopieren von Text in die Zwischenablage
get_follower_ids
- Ruft eine Liste von Benutzer-IDs der Benutzer ab, die den LINE Official Account als Freund hinzugefügt haben. Dies ermöglicht es Ihnen, Benutzer-IDs zum Senden von Nachrichten zu erhalten, ohne sie manuell vorbereiten zu müssen.
- Eingaben:
  - start (string?): Fortsetzungstoken, um das nächste Array von Benutzer-IDs zu erhalten. Wird in der next-Eigenschaft einer vorherigen Antwort zurückgegeben.
  - limit (number?): Die maximale Anzahl von Benutzer-IDs, die in einer einzelnen Anfrage abgerufen werden sollen.

Installation (mit npx)

Voraussetzungen:

Node.js v22 oder höher

Schritt 1: LINE Official Account erstellen

Dieser MCP-Server verwendet einen LINE Official Account. Falls Sie noch keinen haben, erstellen Sie ihn bitte gemäß dieser Anleitung.

Wenn Sie bereits einen LINE Official Account besitzen, aktivieren Sie die Messaging API für Ihren LINE Official Account gemäß dieser Anleitung.

Schritt 2: KI-Agenten konfigurieren

Fügen Sie die folgende Konfiguration für einen KI-Agenten wie Claude Desktop oder Cline hinzu.

Setzen Sie die Umgebungsvariablen oder Argumente wie folgt:

CHANNEL_ACCESS_TOKEN: (erforderlich) Channel Access Token. Sie können diesen gemäß dieser Anleitung bestätigen.
DESTINATION_USER_ID: (optional) Die Standard-Benutzer-ID des Empfängers. Wenn die Eingabe des Tools userId nicht enthält, ist DESTINATION_USER_ID erforderlich. Sie können diese gemäß dieser Anleitung bestätigen.

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

Installation (mit Docker)

Schritt 1: LINE Official Account erstellen

Dieser MCP-Server verwendet einen LINE Official Account. Falls Sie noch keinen haben, erstellen Sie ihn bitte gemäß dieser Anleitung.

Wenn Sie bereits einen LINE Official Account besitzen, aktivieren Sie die Messaging API für Ihren LINE Official Account gemäß dieser Anleitung.

Schritt 2: line-bot-mcp-server-Image erstellen

Klonen Sie dieses Repository:

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

Erstellen Sie das Docker-Image:

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

Schritt 3: KI-Agenten konfigurieren

Fügen Sie die folgende Konfiguration für einen KI-Agenten wie Claude Desktop oder Cline hinzu.

Setzen Sie die Umgebungsvariablen oder Argumente wie folgt:

mcpServers.args: (erforderlich) Der Pfad zu line-bot-mcp-server.
CHANNEL_ACCESS_TOKEN: (erforderlich) Channel Access Token. Sie können diesen gemäß dieser Anleitung bestätigen.
DESTINATION_USER_ID: (optional) Die Standard-Benutzer-ID des Empfängers. Wenn die Eingabe des Tools userId nicht enthält, ist DESTINATION_USER_ID erforderlich. Sie können diese gemäß dieser Anleitung bestätigen.

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

Lokale Entwicklung mit Inspector

Sie können den MCP Inspector verwenden, um den Server lokal zu testen und zu debuggen.

Voraussetzungen

Repository klonen:

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

Abhängigkeiten installieren:

npm install

Projekt bauen:

npm run build

Inspector ausführen

Nachdem Sie das Projekt gebaut haben, können Sie den MCP Inspector starten:

npx @modelcontextprotocol/inspector node dist/index.js \
  -e CHANNEL_ACCESS_TOKEN="YOUR_CHANNEL_ACCESS_TOKEN" \
  -e DESTINATION_USER_ID="YOUR_DESTINATION_USER_ID"

Dadurch wird die MCP Inspector-Oberfläche gestartet, in der Sie mit den LINE Bot MCP Server-Tools interagieren und deren Funktionalität testen können.

Versionierung

Dieses Projekt beachtet die semantische Versionierung.

Siehe http://semver.org/

Mitwirken

Bitte lesen Sie CONTRIBUTING, bevor Sie einen Beitrag leisten.