https://github.com/line/line-bot-mcp-server
MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.
https://github.com/line/line-bot-mcp-server
Last synced: about 2 months ago
JSON representation
MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.
- Host: GitHub
- URL: https://github.com/line/line-bot-mcp-server
- Owner: line
- License: apache-2.0
- Created: 2025-04-04T09:15:05.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-04-17T03:35:07.000Z (2 months ago)
- Last Synced: 2025-04-17T16:28:38.054Z (2 months ago)
- Language: TypeScript
- Homepage:
- Size: 1.17 MB
- Stars: 287
- Watchers: 5
- Forks: 35
- Open Issues: 7
-
Metadata Files:
- Readme: README.ja.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-mcp-servers - LINE Official Account - Integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account. (💬 <a name="communication"></a>Communication)
- awesome-mcp-servers - line/line-bot-mcp-server - Messaging APIを利用したLINE公式アカウントとの統合 (サーバー実装 / 💬 <a name="communication"></a>コミュニケーション)
- mcp-index - LINE Bot Integration Server - Enable AI agents to send and retrieve messages through a LINE Official Account, facilitating user engagement by pushing text and rich flex messages. Interact with user profiles and broadcast messages to all followers using the LINE Messaging API. (APIs and HTTP Requests)
- awesome-mcp-servers - LINE Official Account - Integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account. (Official Servers)
README
# LINE Bot MCP Server
LINE公式アカウントとAI Agentを接続するために、LINE Messaging APIを統合する[Model Context Protocol (MCP)](https://github.com/modelcontextprotocol) Server
> [!NOTE]
> このリポジトリはプレビュー版として提供されています。実験的な目的で提供されており、完全な機能や包括的なサポートが含まれていないことにご注意ください。
## Tools
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): フレックスメッセージが表示できない場合に表示される代替テキスト。
- `message.content` (any): フレックスメッセージの内容。メッセージのレイアウトとコンポーネントを定義するJSONオブジェクト。
- `message.contents.type` (enum): コンテナのタイプ。'bubble'は単一コンテナ、'carousel'は複数のスワイプ可能なバブルを示す。
3. **broadcast_text_message**
- LINE公式アカウントと友だちになっているすべてのユーザーに、LINEでシンプルなテキストメッセージを送信する。
- **入力:**
- `message.text` (string): ユーザーに送信するテキスト。
4. **broadcast_flex_message**
- LINE公式アカウントと友だちになっているすべてのユーザーに、LINEで高度にカスタマイズ可能なフレックスメッセージを送信する。
- **入力:**
- `message.altText` (string): フレックスメッセージが表示できない場合に表示される代替テキスト。
- `message.content` (any): フレックスメッセージの内容。メッセージのレイアウトとコンポーネントを定義するJSONオブジェクト。
- `message.contents.type` (enum): コンテナのタイプ。'bubble'は単一コンテナ、'carousel'は複数のスワイプ可能なバブルを示す。
5. **get_profile**
- LINEユーザーの詳細なプロフィール情報を取得する。表示名、プロフィール画像URL、ステータスメッセージ、言語を取得できる。
- **Inputs:**
- `user_id` (string?): プロフィールを取得したいユーザーのユーザーID。デフォルトはDESTINATION_USER_ID。
## インストール
### Step 1: line-bot-mcp-serverをインストール
要件:
- Node.js v20 以上
このリポジトリをクローンします:
```
git clone [email protected]:line/line-bot-mcp-server.git
```
Node.jsを利用する場合は、必要な依存関係をインストールし、line-bot-mcp-serverをビルドします。Dockerを利用する場合は不要です。:
```
cd line-bot-mcp-server && npm install && npm run build
```
### Step 2: LINE公式アカウントを作成
このMCP ServerはLINE公式アカウントを利用しています。公式アカウントをお持ちでない場合は、[こちらの手順](https://developers.line.biz/ja/docs/messaging-api/getting-started/#create-oa)に従って作成してください。
LINE公式アカウントをお持ちであれば、[こちらの手順](/docs/messaging-api/getting-started/#using-oa-manager)に従ってMessaging APIを有効にしてください。
### Step 3: AI Agentを設定
Claude DesktopやClaudeなどのAI Agentに次の設定を追加してください。
環境変数や引数は次のように設定してください:
- `mcpServers.args`: (必須) `line-bot-mcp-server`へのパス。
- `CHANNEL_ACCESS_TOKEN`: (必須) チャネルアクセストークン。これを取得するには、[こちらの手順](https://developers.line.biz/ja/docs/basics/channel-access-token/#long-lived-channel-access-token)に従ってください。
- `DESTINATION_USER_ID`: (オプション) デフォルトのメッセージ受信者のユーザーID。これを確認するには、[こちらの手順](https://developers.line.biz/ja/docs/messaging-api/getting-user-ids/#get-own-user-id)に従ってください。
### Step 3: AI Agentを設定
Claude DesktopやClaudeなどのAI Agentに次の設定を追加してください。
`CHANNEL_ACCESS_TOKEN`と`DESTINATION_USER_ID`には、先ほど取得したチャネルアクセストークンとユーザーIDをそれぞれ挿入してください。
加えて、`mcpServers.args`にある`line-bot-mcp-server`へのパスを更新してください。
#### Option 1: Node.jsを利用する場合
```json
{
"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"
}
}
}
}
```
#### Option 2: Dockerを利用する場合
まずDockerイメージをビルドします:
```
docker build -t line/line-bot-mcp-server .
```
次のように設定します:
```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" : "FILL_HERE",
"DESTINATION_USER_ID" : "FILL_HERE"
}
}
}
}
```