@portone/mcp-server 0.17.0 → 0.17.1

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.1",
   "name": "portone-mcp-server",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "PortOne MCP Server for Developers",
   "author": {
     "name": "PortOne",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portone/mcp-server",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "포트원 사용자를 위한 MCP (Model Context Protocol) 서버입니다. 포트원 개발자센터, 헬프센터 등 공식 문서 내용을 LLM(Large Language Model)에 제공해 정확한 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.",
   "main": "server/index.js",
   "type": "module",

package/server/index.js

@@ -15,7 +15,7 @@ import { GraphQLClient } from "graphql-request";
 // package.json
 var package_default = {
   name: "@portone/mcp-server",
-  version: "0.17.0",
+  version: "0.17.1",
   description: "\uD3EC\uD2B8\uC6D0 \uC0AC\uC6A9\uC790\uB97C \uC704\uD55C MCP (Model Context Protocol) \uC11C\uBC84\uC785\uB2C8\uB2E4. \uD3EC\uD2B8\uC6D0 \uAC1C\uBC1C\uC790\uC13C\uD130, \uD5EC\uD504\uC13C\uD130 \uB4F1 \uACF5\uC2DD \uBB38\uC11C \uB0B4\uC6A9\uC744 LLM(Large Language Model)\uC5D0 \uC81C\uACF5\uD574 \uC815\uD655\uD55C \uC815\uBCF4\uB97C \uBC14\uD0D5\uC73C\uB85C \uC0AC\uC6A9\uC790\uC758 \uC5F0\uB3D9 \uBC0F \uC9C8\uC758\uB97C \uB3D5\uB3C4\uB85D \uD569\uB2C8\uB2E4.",
   main: "server/index.js",
   type: "module",
@@ -1763,6 +1763,42 @@ import { parse as parse3 } from "graphql";
 import { gql as gql3 } from "graphql-request";
 import { match as match7, P as P6 } from "ts-pattern";
 import z11 from "zod";
+
+// src/tools/utils/requestError.ts
+function toRequestError(error) {
+  const response = error?.response;
+  const rawErrors = response?.errors;
+  if (Array.isArray(rawErrors) && rawErrors.length > 0) {
+    const errors = rawErrors.map((entry) => {
+      const e = entry;
+      const message2 = typeof e.message === "string" && e.message.length > 0 ? e.message : void 0;
+      const code = e.extensions?.code != null ? String(e.extensions.code) : void 0;
+      const path = Array.isArray(e.path) ? e.path.join(".") : void 0;
+      return { message: message2, code, path };
+    });
+    const primary = errors[0];
+    const message = primary.message ?? (primary.code != null ? `GraphQL \uC624\uB958 (code: ${primary.code})` : "GraphQL \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. (\uC11C\uBC84\uAC00 \uC0C1\uC138 \uBA54\uC2DC\uC9C0\uB97C \uBC18\uD658\uD558\uC9C0 \uC54A\uC74C)");
+    return {
+      type: "error",
+      data: { message, type: "GraphQLError", errors }
+    };
+  }
+  if (error instanceof Error) {
+    return {
+      type: "error",
+      data: {
+        message: error.message || error.name || "\uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.",
+        type: error.name
+      }
+    };
+  }
+  return {
+    type: "error",
+    data: { message: "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.", cause: String(error) }
+  };
+}
+
+// src/tools/request/getReconciliations.ts
 var ErrorResponse3 = z11.object({
   __typename: z11.string(),
   message: z11.string().nullable()
@@ -2111,27 +2147,22 @@ async function getReconciliations({
       data
     }));
   } catch (error) {
-    if (error instanceof Error) {
-      return {
-        type: "error",
-        data: error
-      };
-    } else {
-      return {
-        type: "error",
-        data: {
-          message: `\uC54C \uC218 \uC5C6\uB294 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.`,
-          cause: error
-        }
-      };
-    }
+    return toRequestError(error);
   }
 }
 
 // src/tools/utils/dateRange.ts
 var LOOKBACK_MONTHS = 6;
-var MAX_RANGE_MONTHS = 3;
-function validateReconciliationDateRange(from, to) {
+function maxRangeLabel(maxRange) {
+  if ("months" in maxRange) {
+    return `${maxRange.months}\uAC1C\uC6D4`;
+  }
+  if (maxRange.days % 7 === 0) {
+    return `${maxRange.days / 7}\uC8FC`;
+  }
+  return `${maxRange.days}\uC77C`;
+}
+function validateReconciliationDateRange(from, to, maxRange) {
   const fromDate = /* @__PURE__ */ new Date(`${from}T00:00:00Z`);
   const toDate = /* @__PURE__ */ new Date(`${to}T00:00:00Z`);
   if (Number.isNaN(fromDate.getTime()) || Number.isNaN(toDate.getTime())) {
@@ -2149,9 +2180,13 @@ function validateReconciliationDateRange(from, to) {
     return `\uC870\uD68C \uC2DC\uC791\uC77C(from)\uC740 \uCD5C\uADFC ${LOOKBACK_MONTHS}\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD569\uB2C8\uB2E4. ${earliest.toISOString().slice(0, 10)} \uC774\uD6C4\uB85C \uC9C0\uC815\uD574\uC8FC\uC138\uC694.`;
   }
   const maxTo = new Date(fromDate);
-  maxTo.setUTCMonth(maxTo.getUTCMonth() + MAX_RANGE_MONTHS);
+  if ("months" in maxRange) {
+    maxTo.setUTCMonth(maxTo.getUTCMonth() + maxRange.months);
+  } else {
+    maxTo.setUTCDate(maxTo.getUTCDate() + maxRange.days);
+  }
   if (toDate > maxTo) {
-    return `\uC870\uD68C \uAD6C\uAC04\uC740 \uCD5C\uB300 ${MAX_RANGE_MONTHS}\uAC1C\uC6D4\uAE4C\uC9C0 \uAC00\uB2A5\uD569\uB2C8\uB2E4. from(${from}) \uAE30\uC900 ${maxTo.toISOString().slice(0, 10)} \uC774\uB0B4\uB85C to\uB97C \uC9C0\uC815\uD574\uC8FC\uC138\uC694.`;
+    return `\uC870\uD68C \uAD6C\uAC04\uC740 \uCD5C\uB300 ${maxRangeLabel(maxRange)}\uAE4C\uC9C0 \uAC00\uB2A5\uD569\uB2C8\uB2E4. from(${from}) \uAE30\uC900 ${maxTo.toISOString().slice(0, 10)} \uC774\uB0B4\uB85C to\uB97C \uC9C0\uC815\uD574\uC8FC\uC138\uC694.`;
   }
   return null;
 }
@@ -2231,7 +2266,7 @@ var config5 = {
 \uB300\uC0AC \uBD88\uC77C\uCE58 \uC0C1\uC138\uB294 statuses=[NOT_MATCHED] \uB85C \uC870\uD68C \uD6C4 \uAC01 \uAC74\uC758 notMatchedReasons \uB97C \uD655\uC778\uD569\uB2C8\uB2E4.
 \uB300\uC0AC \uBD88\uAC00 \uC0AC\uC720\uB294 INCOMPARABLE \uAC74\uC758 incomparableReason \uD544\uB4DC\uC5D0\uC11C \uD655\uC778\uD569\uB2C8\uB2E4.
 \uB0A0\uC9DC\uB294 \uBC18\uB4DC\uC2DC YYYY-MM-DD \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD558\uBA70, dateType \uC73C\uB85C \uC815\uC0B0\uC77C/\uACB0\uC81C\uC77C \uAE30\uC900\uC744 \uC120\uD0DD\uD569\uB2C8\uB2E4.
-\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 3\uAC1C\uC6D4\uC785\uB2C8\uB2E4.
+\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 2\uC8FC\uC785\uB2C8\uB2E4.
 store \uC544\uC774\uB514\uB294 list_stores \uB3C4\uAD6C\uB85C \uBA3C\uC800 \uC870\uD68C\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`,
   inputSchema: InputSchema4.shape,
   outputSchema: OutputSchema5.shape
@@ -2287,7 +2322,9 @@ function init5(tokenProvider, client) {
     first,
     after
   }) => {
-    const dateRangeError = validateReconciliationDateRange(from, to);
+    const dateRangeError = validateReconciliationDateRange(from, to, {
+      days: 14
+    });
     if (dateRangeError != null) {
       return toolErrorResult({
         type: "error",
@@ -2616,15 +2653,6 @@ async function getSettlementStatistics({
     return toRequestError(error);
   }
 }
-function toRequestError(error) {
-  if (error instanceof Error) {
-    return { type: "error", data: error };
-  }
-  return {
-    type: "error",
-    data: { message: `\uC54C \uC218 \uC5C6\uB294 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.`, cause: error }
-  };
-}
 
 // src/tools/getSettlementStatistics.ts
 var name6 = "getSettlementStatistics";
@@ -2659,14 +2687,16 @@ var config6 = {
 
 \uAC80\uC0C9 \uAD6C\uAC04 \uB0B4 \uD1B5\uD654\uBCC4 \uD569\uC0B0 \uD1B5\uACC4(\uC815\uC0B0/\uC815\uC0B0\uC608\uC815 \uAE08\uC561\xB7\uAC74\uC218)\uC640 \uC77C\uBCC4 \uD1B5\uACC4\uB97C \uC81C\uACF5\uD569\uB2C8\uB2E4.
 \uB0A0\uC9DC\uB294 \uBC18\uB4DC\uC2DC YYYY-MM-DD \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD569\uB2C8\uB2E4.
-\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 3\uAC1C\uC6D4\uC785\uB2C8\uB2E4.
+\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 1\uAC1C\uC6D4\uC785\uB2C8\uB2E4.
 store \uC544\uC774\uB514\uB294 list_stores \uB3C4\uAD6C\uB85C \uBA3C\uC800 \uC870\uD68C\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`,
   inputSchema: InputSchema5.shape,
   outputSchema: OutputSchema6.shape
 };
 function init6(tokenProvider, client) {
   return async ({ store, from, to }) => {
-    const dateRangeError = validateReconciliationDateRange(from, to);
+    const dateRangeError = validateReconciliationDateRange(from, to, {
+      months: 1
+    });
     if (dateRangeError != null) {
       return toolErrorResult({
         type: "error",
@@ -2753,14 +2783,16 @@ var config7 = {
 
 \uAC01 \uC77C\uC790\uBCC4\uB85C \uC815\uC0B0 \uAE08\uC561/\uAC74\uC218, PG \uC218\uC218\uB8CC, \uCDE8\uC18C, \uD6C4\uBCF4\uC815 \uD569\uC0B0\uCE58\uC640 \uC0C1\uC810\xB7PG\uBCC4 \uC0C1\uC138 \uB0B4\uC5ED\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.
 \uB0A0\uC9DC\uB294 \uBC18\uB4DC\uC2DC YYYY-MM-DD \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD569\uB2C8\uB2E4.
-\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 3\uAC1C\uC6D4\uC785\uB2C8\uB2E4.
+\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 1\uAC1C\uC6D4\uC785\uB2C8\uB2E4.
 store \uC544\uC774\uB514\uB294 list_stores \uB3C4\uAD6C\uB85C \uBA3C\uC800 \uC870\uD68C\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`,
   inputSchema: InputSchema6.shape,
   outputSchema: OutputSchema7.shape
 };
 function init7(tokenProvider, client) {
   return async ({ store, from, to, first, after }) => {
-    const dateRangeError = validateReconciliationDateRange(from, to);
+    const dateRangeError = validateReconciliationDateRange(from, to, {
+      months: 1
+    });
     if (dateRangeError != null) {
       return toolErrorResult({
         type: "error",