gm-mcp 1.1.2 → 1.1.4

package/dist/index.js

@@ -69,8 +69,10 @@ exports.server.tool("statistic_salary_x3_in_range", "Get statistic salary x3 wit
         sendMessageToLark: (0, env_1.getEnv)().SEND_MESSAGE_TO_LARK,
     });
 }));
-exports.server.tool("debt_collection_by_month", "The company's debt collection rate by month", {
-    month: zod_1.default.string({ description: "Month to get data, month must be represented with format MM/yyyy" }),
+exports.server.tool("debt_collection_by_month", "The company's debt collection information by month", {
+    month: zod_1.default.string({
+        description: "Month to get data,if year is not provided, please use current year (in Vietnam timezone) instead of, month must be represented with format MM/yyyy",
+    }),
     company_name: zod_1.default.string({ description: "Company name to get data" }),
 }, (args) => __awaiter(void 0, void 0, void 0, function* () {
     const { month, company_name } = args;

package/dist/services/lark-base.service.d.ts

@@ -1,5 +1,15 @@
 import { LarkRecord } from "./types/lark.type";
-export declare function fetchReportRecords(p: {
+export declare function fetchLarkBaseRecords(p: {
     view_id: string;
     field_names: string[];
-}): Promise<LarkRecord[]>;
+    app_token: string;
+    table_id: string;
+    page_size: number;
+    page_token?: string;
+}): Promise<{
+    items: LarkRecord[];
+    page_token: string;
+    has_more: boolean;
+    total: number;
+}>;
+export declare function fetchDebtCollectionRecords(page_token?: string): Promise<LarkRecord[]>;

package/dist/services/lark-base.service.js

@@ -12,22 +12,48 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchReportRecords = fetchReportRecords;
+exports.fetchLarkBaseRecords = fetchLarkBaseRecords;
+exports.fetchDebtCollectionRecords = fetchDebtCollectionRecords;
 const axios_1 = __importDefault(require("axios"));
 const lark_service_1 = require("./lark.service");
-function fetchReportRecords(p) {
+const report_columns_1 = require("./constants/report-columns");
+// Must replace by env config later
+const DEBT_COLLECTION_VIEW_ID = "vewI23hNnx";
+const DEBT_COLLECTION_TABLE_ID = "tblQGKjGd8MnK5qs";
+const DEBT_COLLECTION_APP_TOKEN = "V5akbIXqfaBvXqs8twfl6rALgLd";
+function fetchLarkBaseRecords(p) {
     return __awaiter(this, void 0, void 0, function* () {
         const access_token = yield (0, lark_service_1.getLarkTenantAccessToken)();
+        const { view_id, table_id, app_token, field_names, page_size, page_token } = p;
         const appToken = "V5akbIXqfaBvXqs8twfl6rALgLd";
         const tableId = "tblQGKjGd8MnK5qs";
-        const url = `https://open.larksuite.com/open-apis/bitable/v1/apps/${appToken}/tables/${tableId}/records/search`;
+        const url = `https://open.larksuite.com/open-apis/bitable/v1/apps/${app_token}/tables/${table_id}/records/search`;
         return axios_1.default
-            .post(url, p, {
-            params: { page_size: 500 },
+            .post(url, { view_id, field_names }, {
+            params: { page_size, page_token },
             headers: {
                 Authorization: "Bearer " + access_token,
             },
         })
-            .then((res) => res.data.data.items);
+            .then((res) => res.data.data);
+    });
+}
+function fetchDebtCollectionRecords(page_token) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const fieldNames = report_columns_1.REPORT_COLUMS.map((item) => item.field_name);
+        const { has_more, items, page_token: nextPageToken, total, } = yield fetchLarkBaseRecords({
+            view_id: DEBT_COLLECTION_VIEW_ID,
+            field_names: fieldNames,
+            app_token: DEBT_COLLECTION_APP_TOKEN,
+            table_id: DEBT_COLLECTION_TABLE_ID,
+            page_size: 500,
+            page_token: page_token,
+        });
+        console.log(total);
+        if (!has_more) {
+            return items;
+        }
+        const result = [...items];
+        return result.concat(yield fetchDebtCollectionRecords(nextPageToken));
     });
 }

package/dist/test.js

@@ -14,9 +14,11 @@ const lark_tool_1 = require("./tools/lark-tool");
 function setupTest() {
     return __awaiter(this, void 0, void 0, function* () {
         (0, env_1.ensureEnvVariables)();
-        const compnay = "BGG";
-        const month = "12/2025";
-        const res = yield (0, lark_tool_1.debtCollectionRateTool)({ sendMessageToLark: false, companyName: compnay, monthDate: month });
+        // const r = await fetchDebtCollectionRecords();
+        // console.log(r.length);
+        // const compnay = "BGG";
+        // const month = "12/2025";
+        const res = yield (0, lark_tool_1.debtCollectionRateTool)({ sendMessageToLark: true, companyName: 'SHYANG', monthDate: '07/2025' });
         console.log(res);
         // const fieldNames = REPORT_COLUMS.map((item) => item.field_name);
         // try {

package/dist/tools/lark-tool.js

@@ -18,8 +18,13 @@ const lark_service_1 = require("../services/lark.service");
 const companyKey = "CÔNG TY";
 const preiodKey = "KỲ LƯƠNG";
 const debtCollectionRateKey = "TỈ LỆ THU NỢ";
+const debReductionMonthKey = "THÁNG CẮT NỢ";
+const productKey = "Loại Sản phẩm";
+const monthReductionDebtKey = "THÁNG CẮT NỢ";
+const statusKey = "TRẠNG THÁI";
 function debtCollectionRateTool(options) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _c, _d;
         const { sendMessageToLark, companyName, monthDate } = options;
         const monthParts = (0, helpers_1.extractMonth)(monthDate);
         if (monthParts === null) {
@@ -28,28 +33,39 @@ function debtCollectionRateTool(options) {
         const { month, year } = monthParts;
         const fieldNames = report_columns_1.REPORT_COLUMS.map((item) => item.field_name);
         try {
-            const records = yield (0, lark_base_service_1.fetchReportRecords)({ view_id: "vewI23hNnx", field_names: fieldNames });
+            const records = yield (0, lark_base_service_1.fetchDebtCollectionRecords)();
             // console.log(records);
             // Find by name first
-            const companyNames = records.map((item) => (item.fields["CÔNG TY"] || ""));
+            const companyNames = records.map((item) => (item.fields[companyKey] || ""));
             // console.log(companyNames);
             // const searchTems = "DENKO";
             // const monthTerm = "12";
             const foundName = (0, search_like_1.searchLike)(companyName, companyNames)[0];
-            const companiesMatchName = records.filter((item) => item.fields["CÔNG TY"] === foundName);
+            const companiesMatchName = records.filter((item) => item.fields[companyKey] === foundName);
             // console.log(companiesMatchName);
-            // Find by pay period
+            // Find by debt reduction month, search fully match
+            const foundMonths = companiesMatchName.filter((item) => compareReductionDebtMonth(item.fields[debReductionMonthKey], month.toString()));
             const foundMonth = (0, search_like_1.searchLike)(month.toString(), companiesMatchName.map((item) => item.fields["KỲ LƯƠNG"]))[0];
-            console.log(foundMonth);
+            console.log(foundMonths);
             const finalCompnay = companiesMatchName.find((item) => item.fields["KỲ LƯƠNG"] === foundMonth);
+            // console.log(finalCompnay);
+            const messages = [];
+            for (const item of foundMonths) {
+                messages.push([
+                    `Sản phẩm: ${item.fields[productKey] || "N/A"}`,
+                    `Kỳ lương: ${(item === null || item === void 0 ? void 0 : item.fields[preiodKey]) || "N/A"}`,
+                    `Tr.thái cắt nợ: ${((_d = (_c = item === null || item === void 0 ? void 0 : item.fields[statusKey]) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.text) || "N/A"}`,
+                    `Tháng cắt nợ: ${item.fields[monthReductionDebtKey] || "N/A"}`,
+                    `Tỷ lệ thu nợ: ${typeof item.fields[debtCollectionRateKey] === "undefined"
+                        ? "N/A"
+                        : round(Number(item.fields[debtCollectionRateKey])) + "%"}`,
+                ].join("<br>"));
+            }
+            // return {} as any;
             if (sendMessageToLark) {
                 yield (0, lark_service_1.sendReportOpsGroup)({
-                    title: "Tỉ lệ thu nợ",
-                    message_content: [
-                        `Công ty: ${(finalCompnay === null || finalCompnay === void 0 ? void 0 : finalCompnay.fields[companyKey]) || "N/A"}`,
-                        `Kỳ lương: ${(finalCompnay === null || finalCompnay === void 0 ? void 0 : finalCompnay.fields[preiodKey]) || "N/A"}`,
-                        `Tỷ lệ thu nợ: ${Number(finalCompnay === null || finalCompnay === void 0 ? void 0 : finalCompnay.fields[debtCollectionRateKey]) * 100}%`,
-                    ].join("<hr>"),
+                    title: `Tỉ lệ thu nợ - ${foundName}`,
+                    message_content: messages.join("<hr>"),
                 });
             }
             return { content: [{ type: "text", text: JSON.stringify(finalCompnay) }] };
@@ -60,3 +76,11 @@ function debtCollectionRateTool(options) {
         }
     });
 }
+function compareReductionDebtMonth(a, b) {
+    const _a = a.toLowerCase().trim().replace("tháng", "");
+    const _b = b.toLowerCase().trim().replace("tháng", "");
+    return parseInt(_a, 10) === parseInt(_b, 10);
+}
+function round(x) {
+    return Math.round(x * 10000) / 100;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-mcp",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Mcp server for Gm",
   "main": "dist/index.js",
   "scripts": {

package/src/index.ts

@@ -91,9 +91,12 @@ server.tool(
 
 server.tool(
   "debt_collection_by_month",
-  "The company's debt collection rate by month",
+  "The company's debt collection information by month",
   {
-    month: z.string({ description: "Month to get data, month must be represented with format MM/yyyy" }),
+    month: z.string({
+      description:
+        "Month to get data,if year is not provided, please use current year (in Vietnam timezone) instead of, month must be represented with format MM/yyyy",
+    }),
     company_name: z.string({ description: "Company name to get data" }),
   },
   async (args) => {

package/src/services/lark-base.service.ts

@@ -1,18 +1,60 @@
 import axios from "axios";
 import { LarkRecord } from "./types/lark.type";
 import { getLarkTenantAccessToken } from "./lark.service";
+import { REPORT_COLUMS } from "./constants/report-columns";
 
-export async function fetchReportRecords(p: { view_id: string; field_names: string[] }) {
+// Must replace by env config later
+const DEBT_COLLECTION_VIEW_ID = "vewI23hNnx";
+const DEBT_COLLECTION_TABLE_ID = "tblQGKjGd8MnK5qs";
+const DEBT_COLLECTION_APP_TOKEN = "V5akbIXqfaBvXqs8twfl6rALgLd";
+
+export async function fetchLarkBaseRecords(p: {
+  view_id: string;
+  field_names: string[];
+  app_token: string;
+  table_id: string;
+  page_size: number;
+  page_token?: string;
+}) {
   const access_token = await getLarkTenantAccessToken();
+  const { view_id, table_id, app_token, field_names, page_size, page_token } = p;
   const appToken = "V5akbIXqfaBvXqs8twfl6rALgLd";
   const tableId = "tblQGKjGd8MnK5qs";
-  const url = `https://open.larksuite.com/open-apis/bitable/v1/apps/${appToken}/tables/${tableId}/records/search`;
+  const url = `https://open.larksuite.com/open-apis/bitable/v1/apps/${app_token}/tables/${table_id}/records/search`;
   return axios
-    .post<{ data: { items: LarkRecord[] } }>(url, p, {
-      params: { page_size: 500 },
-      headers: {
-        Authorization: "Bearer " + access_token,
-      },
-    })
-    .then((res) => res.data.data.items);
+    .post<{ data: { items: LarkRecord[]; page_token: string; has_more: boolean; total: number } }>(
+      url,
+      { view_id, field_names },
+      {
+        params: { page_size, page_token },
+        headers: {
+          Authorization: "Bearer " + access_token,
+        },
+      }
+    )
+    .then((res) => res.data.data);
+}
+
+export async function fetchDebtCollectionRecords(page_token?: string): Promise<LarkRecord[]> {
+  const fieldNames = REPORT_COLUMS.map((item) => item.field_name);
+  const {
+    has_more,
+    items,
+    page_token: nextPageToken,
+    total,
+  } = await fetchLarkBaseRecords({
+    view_id: DEBT_COLLECTION_VIEW_ID,
+    field_names: fieldNames,
+    app_token: DEBT_COLLECTION_APP_TOKEN,
+    table_id: DEBT_COLLECTION_TABLE_ID,
+    page_size: 500,
+    page_token: page_token,
+  });
+  console.log(total);
+
+  if (!has_more) {
+    return items;
+  }
+  const result: LarkRecord[] = [...items];
+  return result.concat(await fetchDebtCollectionRecords(nextPageToken));
 }

package/src/test.ts

@@ -1,7 +1,7 @@
 import { ensureEnvVariables, getEnv } from "./env";
 import { searchLike } from "./helpers/search-like";
 import { REPORT_COLUMS } from "./services/constants/report-columns";
-import { fetchReportRecords } from "./services/lark-base.service";
+import { fetchDebtCollectionRecords, fetchLarkBaseRecords } from "./services/lark-base.service";
 import { sendLarkTextMessage, sendMessageToX3Group } from "./services/lark.service";
 import {
   statisticX3RangeTool,
@@ -14,9 +14,13 @@ import { debtCollectionRateTool } from "./tools/lark-tool";
 
 async function setupTest() {
   ensureEnvVariables();
-  const compnay = "BGG";
-  const month = "12/2025";
-  const res = await debtCollectionRateTool({ sendMessageToLark: false, companyName: compnay, monthDate: month });
+
+  // const r = await fetchDebtCollectionRecords();
+  // console.log(r.length);
+
+  // const compnay = "BGG";
+  // const month = "12/2025";
+  const res = await debtCollectionRateTool({ sendMessageToLark: true, companyName: 'SHYANG', monthDate: '07/2025' });
   console.log(res);
 
   // const fieldNames = REPORT_COLUMS.map((item) => item.field_name);

package/src/tools/lark-tool.ts

@@ -2,12 +2,16 @@ import { CallToolResult } from "@modelcontextprotocol/sdk/types";
 import { extractMonth } from "../helpers";
 import { searchLike } from "../helpers/search-like";
 import { REPORT_COLUMS } from "../services/constants/report-columns";
-import { fetchReportRecords } from "../services/lark-base.service";
+import { fetchDebtCollectionRecords, fetchLarkBaseRecords } from "../services/lark-base.service";
 import { sendReportOpsGroup } from "../services/lark.service";
 
 const companyKey = "CÔNG TY";
 const preiodKey = "KỲ LƯƠNG";
 const debtCollectionRateKey = "TỈ LỆ THU NỢ";
+const debReductionMonthKey = "THÁNG CẮT NỢ";
+const productKey = "Loại Sản phẩm";
+const monthReductionDebtKey = "THÁNG CẮT NỢ";
+const statusKey = "TRẠNG THÁI";
 
 export async function debtCollectionRateTool(options: {
   sendMessageToLark: boolean;
@@ -22,34 +26,53 @@ export async function debtCollectionRateTool(options: {
   const { month, year } = monthParts;
   const fieldNames = REPORT_COLUMS.map((item) => item.field_name);
   try {
-    const records = await fetchReportRecords({ view_id: "vewI23hNnx", field_names: fieldNames });
+    const records = await fetchDebtCollectionRecords();
     // console.log(records);
 
     // Find by name first
-    const companyNames = records.map((item) => (item.fields["CÔNG TY"] || "") as string);
+    const companyNames = records.map((item) => (item.fields[companyKey] || "") as string);
     // console.log(companyNames);
     // const searchTems = "DENKO";
     // const monthTerm = "12";
     const foundName = searchLike(companyName, companyNames)[0];
-    const companiesMatchName = records.filter((item) => item.fields["CÔNG TY"] === foundName);
+    const companiesMatchName = records.filter((item) => item.fields[companyKey] === foundName);
     // console.log(companiesMatchName);
 
-    // Find by pay period
+    // Find by debt reduction month, search fully match
+    const foundMonths = companiesMatchName.filter((item) =>
+      compareReductionDebtMonth(item.fields[debReductionMonthKey], month.toString())
+    );
     const foundMonth = searchLike(
       month.toString(),
       companiesMatchName.map((item) => item.fields["KỲ LƯƠNG"])
     )[0];
-    console.log(foundMonth);
+    console.log(foundMonths);
     const finalCompnay = companiesMatchName.find((item) => item.fields["KỲ LƯƠNG"] === foundMonth);
+    // console.log(finalCompnay);
+
+    const messages: string[] = [];
+    for (const item of foundMonths) {
+      messages.push(
+        [
+          `Sản phẩm: ${item.fields[productKey] || "N/A"}`,
+          `Kỳ lương: ${item?.fields[preiodKey] || "N/A"}`,
+          `Tr.thái cắt nợ: ${item?.fields[statusKey]?.[0]?.text || "N/A"}`,
+          `Tháng cắt nợ: ${item.fields[monthReductionDebtKey] || "N/A"}`,
+          `Tỷ lệ thu nợ: ${
+            typeof item.fields[debtCollectionRateKey] === "undefined"
+              ? "N/A"
+              : round(Number(item.fields[debtCollectionRateKey])) + "%"
+          }`,
+        ].join("<br>")
+      );
+    }
+
+    // return {} as any;
 
     if (sendMessageToLark) {
       await sendReportOpsGroup({
-        title: "Tỉ lệ thu nợ",
-        message_content: [
-          `Công ty: ${finalCompnay?.fields[companyKey] || "N/A"}`,
-          `Kỳ lương: ${finalCompnay?.fields[preiodKey] || "N/A"}`,
-          `Tỷ lệ thu nợ: ${Number(finalCompnay?.fields[debtCollectionRateKey]) * 100}%`,
-        ].join("<hr>"),
+        title: `Tỉ lệ thu nợ - ${foundName}`,
+        message_content: messages.join("<hr>"),
       });
     }
     return { content: [{ type: "text", text: JSON.stringify(finalCompnay) }] };
@@ -58,3 +81,13 @@ export async function debtCollectionRateTool(options: {
     return { content: [{ type: "text", text: JSON.stringify(e) }] };
   }
 }
+
+function compareReductionDebtMonth(a: string, b: string) {
+  const _a = a.toLowerCase().trim().replace("tháng", "");
+  const _b = b.toLowerCase().trim().replace("tháng", "");
+  return parseInt(_a, 10) === parseInt(_b, 10);
+}
+
+function round(x: number) {
+  return Math.round(x * 10000) / 100;
+}