feat: Add get_follower_ids tool #40
+77
−30
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -41,18 +41,29 @@ LINE公式アカウントとAI Agentを接続するために、LINE Messaging AP | |
| - LINE公式アカウントのメッセージ容量と消費量を取得します。月間メッセージ制限と現在の使用量が表示されます。 | ||
| - **入力:** | ||
| - なし | ||
| 7. **get_follower_ids** | ||
| - LINE公式アカウントを友だち追加したユーザーのユーザーID一覧を取得します。 | ||
| - **入力:** | ||
| - `start` (string?): ページネーション用の継続トークン。省略時は先頭から取得します。 | ||
| - `limit` (number?): 取得するユーザーIDの最大数（1～1000）。デフォルトは1000。 | ||
| - **出力:** | ||
| - `userIds` (配列): ユーザーIDのリスト。 | ||
kkdai marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| - `next` (string?): 次ページ取得用トークン。存在する場合はこの値で再度リクエストしてください。 | ||
| - `total` (number?): ユーザーIDの総数（取得できる場合）。 | ||
| - **注意:** | ||
| - 認証済みまたはプレミアムアカウントのみ利用可能です。 | ||
| - 一部ユーザーIDはプライバシーやユーザー操作により取得できない場合があります（詳細は[こちら](https://developers.line.biz/ja/reference/messaging-api/#get-follower-ids-obtainable-ids)を参照してください）。 | ||
|
|
||
| ## インストール (npxを使用) | ||
|
|
||
| 要件: | ||
|
|
||
| - Node.js v20 以上 | ||
kkdai marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| ### Step 1: LINE公式アカウントを作成 | ||
|
|
||
| このMCP ServerはLINE公式アカウントを利用しています。公式アカウントをお持ちでない場合は、[こちらの手順](https://developers.line.biz/ja/docs/messaging-api/getting-started/#create-oa)に従って作成してください。 | ||
|
|
||
|
Comment on lines
-54
to
-55
|
||
| ### Step 2: AI Agentを設定 | ||
|
|
||
| Claude DesktopやClaudeなどのAI Agentに次の設定を追加してください。 | ||
|
|
@@ -96,6 +107,7 @@ git clone [email protected]:line/line-bot-mcp-server.git | |
| ``` | ||
|
|
||
| Dockerイメージをビルドします: | ||
|
|
||
| ``` | ||
| docker build -t line/line-bot-mcp-server . | ||
| ``` | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -36,6 +36,7 @@ | |
| "dependencies": { | ||
| "@line/bot-sdk": "^9.8.0", | ||
| "@modelcontextprotocol/sdk": "^1.8.0", | ||
| "axios": "^1.9.0", | ||
| "zod": "^3.24.2" | ||
| }, | ||
| "devDependencies": { | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -21,6 +21,8 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js" | |||||
| import * as line from "@line/bot-sdk"; | ||||||
| import { z } from "zod"; | ||||||
| import { LINE_BOT_MCP_SERVER_VERSION, USER_AGENT } from "./version.js"; | ||||||
| import pkg from "../package.json" with { type: "json" }; | ||||||
| import axios from "axios"; | ||||||
|
Comment on lines
+24
to
+25
There was a problem hiding this comment.
Suggested change
|
||||||
|
|
||||||
| const NO_USER_ID_ERROR = | ||||||
| "Error: Specify the userId or set the DESTINATION_USER_ID in the environment variables of this MCP Server."; | ||||||
|
|
@@ -94,8 +96,8 @@ const flexMessageSchema = z.object({ | |||||
| .passthrough() | ||||||
| .describe( | ||||||
| "Flexible container structure following LINE Flex Message format. For 'bubble' type, can include header, " + | ||||||
| "hero, body, footer, and styles sections. For 'carousel' type, includes an array of bubble containers in " + | ||||||
| "the 'contents' property.", | ||||||
| ), | ||||||
| }); | ||||||
|
|
||||||
|
|
@@ -126,7 +128,7 @@ server.tool( | |||||
| server.tool( | ||||||
| "push_flex_message", | ||||||
| "Push a highly customizable flex message to a user via LINE. Supports both bubble (single container) and carousel " + | ||||||
| "(multiple swipeable bubbles) layouts.", | ||||||
| { | ||||||
| userId: userIdSchema, | ||||||
| message: flexMessageSchema, | ||||||
|
|
@@ -153,7 +155,7 @@ server.tool( | |||||
| server.tool( | ||||||
| "broadcast_text_message", | ||||||
| "Broadcast a simple text message via LINE to all users who have followed your LINE Official Account. Use this for sending " + | ||||||
| "plain text messages without formatting. Please be aware that this message will be sent to all users.", | ||||||
| { | ||||||
| message: textMessageSchema, | ||||||
| }, | ||||||
|
|
@@ -174,8 +176,8 @@ server.tool( | |||||
| server.tool( | ||||||
| "broadcast_flex_message", | ||||||
| "Broadcast a highly customizable flex message via LINE to all users who have added your LINE Official Account. " + | ||||||
| "Supports both bubble (single container) and carousel (multiple swipeable bubbles) layouts. Please be aware that " + | ||||||
| "this message will be sent to all users.", | ||||||
| { | ||||||
| message: flexMessageSchema, | ||||||
| }, | ||||||
|
|
@@ -229,6 +231,37 @@ server.tool( | |||||
| }, | ||||||
| ); | ||||||
|
|
||||||
| server.tool( | ||||||
| "get_follower_ids", | ||||||
| "Gets the list of User IDs of users who have added your LINE Official Account as a friend.", | ||||||
| { | ||||||
| start: z | ||||||
| .string() | ||||||
| .optional() | ||||||
| .describe( | ||||||
| "Value of the continuation token found in the next property of the JSON object returned in the response. Include this parameter to get the next array of user IDs. If omitted, fetches from the beginning.", | ||||||
| ), | ||||||
| limit: z | ||||||
| .int() | ||||||
| .min(1) | ||||||
| .max(1000) | ||||||
| .default(300) | ||||||
| .describe( | ||||||
| "Maximum number of user IDs to retrieve (1-1000). Default is 300.", | ||||||
| ), | ||||||
| }, | ||||||
| async ({ start, limit }: { start?: string; limit?: number }) => { | ||||||
| try { | ||||||
| const response = messagingApiClient.getFollowers(start, limit); | ||||||
| return createSuccessResponse(response); | ||||||
| } catch (error) { | ||||||
| return createErrorResponse( | ||||||
| `Failed to get follower ids: ${error.message}`, | ||||||
| ); | ||||||
| } | ||||||
| }, | ||||||
| ); | ||||||
|
|
||||||
| async function main() { | ||||||
| if (!process.env.CHANNEL_ACCESS_TOKEN) { | ||||||
| console.error("Please set CHANNEL_ACCESS_TOKEN"); | ||||||
|
|
||||||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.