feat: add get_follower_ids tool, update README, and remove unused code (#40)

Update src/index.ts

Co-authored-by: Yuta Euchi <[email protected]>

Update src/index.ts

Co-authored-by: Yuta Euchi <[email protected]>

Update src/index.ts

Co-authored-by: Yuta Euchi <[email protected]>

Update README.md

Co-authored-by: Yuta Euchi <[email protected]>

Update README.ja.md

Co-authored-by: Yuta Euchi <[email protected]>

Update README.ja.md

Co-authored-by: Yuta Euchi <[email protected]>

chore(deps): update pnpm to v10.11.0 (#67)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update dependency @types/node to v22.15.18 (#69)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(deps): update dependency @modelcontextprotocol/sdk to v1.11.3 (#70)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

Update README.md

Co-authored-by: Yuta Euchi <[email protected]>

✨ Add get_follower_ids tool to retrieve user IDs of followers for LINE Official Account

📝 Update README.ja.md to remove redundant information and clarify get_follower_ids tool details.

refactor(code): remove unused get_message_quota tool

Author: kkdai

README.ja.md

@@ -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のリスト。
+     - `next` (string?): 次ページ取得用トークン。存在する場合はこの値で再度リクエストしてください。
+     - `total` (number?): ユーザーIDの総数（取得できる場合）。
+   - **注意:**
+     - 認証済みまたはプレミアムアカウントのみ利用可能です。
+     - 一部ユーザーIDはプライバシーやユーザー操作により取得できない場合があります（詳細は[こちら](https://developers.line.biz/ja/reference/messaging-api/#get-follower-ids-obtainable-ids)を参照してください）。
 
 ## インストール (npxを使用)
 
 要件:
+
 - Node.js v20 以上
 
 ### Step 1: LINE公式アカウントを作成
 
 このMCP ServerはLINE公式アカウントを利用しています。公式アカウントをお持ちでない場合は、[こちらの手順](https://developers.line.biz/ja/docs/messaging-api/getting-started/#create-oa)に従って作成してください。
 
-LINE公式アカウントをお持ちであれば、[こちらの手順](https://developers.line.biz/ja/docs/messaging-api/getting-started/#using-oa-manager)に従ってMessaging APIを有効にしてください。
-
 ### 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 .
 ```

README.md

@@ -43,21 +43,34 @@
    - Get the message quota and consumption of the LINE Official Account. This shows the monthly message limit and current usage.
    - **Inputs:**
      - None
+7. **get_follower_ids**
+   - Gets the list of User IDs of users who have added your LINE Official Account as a friend.
+   - **Inputs:**
+     - `start` (string?): Continuation token for pagination. If omitted, fetches from the beginning.
+     - `limit` (number?): Maximum number of user IDs to retrieve (1-1000). Default is 1000.
+   - **Returns:**
+     - `userIds` (array): List of user IDs.
+     - `next` (string?): Token for the next page. If present, repeat the request with this value to get more user IDs.
+     - `total` (number?): Total number of user IDs (if available).
+   - **Notes:**
+     - Only available for verified or premium accounts.
+     - Some user IDs may not be included due to privacy or user actions (see [documents](https://developers.line.biz/en/reference/messaging-api/#get-follower-ids-obtainable-ids) for details).
 
 ## Installation (Using npx)
 
 requirements:
+
 - Node.js v20 or later
 
 ### Step 1: Create LINE Official Account
 
-This MCP server utilizes a LINE Official Account. If you do not have one, please create it by following [this instructions](https://developers.line.biz/en/docs/messaging-api/getting-started/#create-oa). 
+This MCP server utilizes a LINE Official Account. If you do not have one, please create it by following [this instructions](https://developers.line.biz/en/docs/messaging-api/getting-started/#create-oa).
 
 If you have a LINE Official Account, enable the Messaging API for your LINE Official Account by following [this instructions](https://developers.line.biz/en/docs/messaging-api/getting-started/#using-oa-manager).
 
 ### Step 2: Configure AI Agent
 
-Please add the following configuration for an AI Agent like Claude Desktop or Cline. 
+Please add the following configuration for an AI Agent like Claude Desktop or Cline.
 
 Set the environment variables or arguments as follows:
 
@@ -89,7 +102,6 @@ This MCP server utilizes a LINE Official Account. If you do not have one, please
 
 If you have a LINE Official Account, enable the Messaging API for your LINE Official Account by following [this instructions](https://developers.line.biz/en/docs/messaging-api/getting-started/#using-oa-manager).
 
-
 ### Step 2: Build line-bot-mcp-server image
 
 Clone this repository:
@@ -115,7 +127,6 @@ Set the environment variables or arguments as follows:
 - `DESTINATION_USER_ID`: (optional) The default user ID of the recipient. If the Tool's input does not include `user_id`, `DESTINATION_USER_ID` is required.
 You can confirm this by following [this instructions](https://developers.line.biz/en/docs/messaging-api/getting-user-ids/#get-own-user-id).
 
-
 ```json
 {
   "mcpServers": {
@@ -144,7 +155,7 @@ You can confirm this by following [this instructions](https://developers.line.bi
 
 This project respects semantic versioning
 
-See http://semver.org/
+See <http://semver.org/>
 
 ## Contributing
 

package-lock.json

@@ -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": {
@@ -46,5 +47,5 @@
     "typescript": "^5.6.2"
   },
   "license": "Apache-2.0",
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  "packageManager": "pnpm@10.11.0+sha512.6540583f41cc5f628eb3d9773ecee802f4f9ef9923cc45b69890fb47991d4b092964694ec3a4f738a420c918a333062c8b925d312f42e4f0c263eb603551f977"
 }

package.json

@@ -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";
 
 const NO_USER_ID_ERROR =
   "Error: Specify the userId or set the DESTINATION_USER_ID in the environment variables of this MCP Server.";
@@ -229,6 +231,46 @@ 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(
+        "Continuation token for pagination. If omitted, fetches from the beginning.",
+      ),
+    limit: z
+      .number()
+      .int()
+      .min(1)
+      .max(1000)
+      .optional()
+      .describe(
+        "Maximum number of user IDs to retrieve (1-1000). Default is 1000.",
+      ),
+  },
+  async ({ start, limit }: { start?: string; limit?: number }) => {
+    try {
+      const params = new URLSearchParams();
+      if (limit) params.append("limit", limit.toString());
+      if (start) params.append("start", start);
+      const res = await axios.get("https://api.line.me/v2/bot/followers/ids", {
+        params,
+        headers: {
+          Authorization: `Bearer ${channelAccessToken}`,
+        },
+      });
+      return createSuccessResponse(res.data);
+    } 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");