@portone/mcp-server 0.15.0-alpha.3 → 0.15.0-alpha.5

package/assets/docs/help/core-service/channel-setting/kcp_channel.md

@@ -291,7 +291,7 @@ datetime: 2025-03-03T15:00:00.000Z
     - 인증창 호출 시 업체 측에서 전달하는 Ret\_URL(본인확인 인증 결과 리턴 페이지 설정)이 해당 메뉴에 등록되어 있지 않으면 서비스 이용이 불가합니다.
 
 * 인증결과를 받을 URL을 설정 방법
-  - 인증결과 경로 등록 URL :  <https://channel-service.prod.iamport.co/>
+  - 인증결과 경로 등록 URL :  <https://checkout-service.prod.iamport.co/>
 
 <Accordion title="▶KCP 관리자페이지>URL설정 경로 이미지 참고" image="https://help.portone.io/uploads/KCP_본인인증3333.png" />
 

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.1",
   "name": "portone-mcp-server",
-  "version": "0.15.0-alpha.3",
+  "version": "0.15.0-alpha.5",
   "description": "PortOne MCP Server for Developers",
   "author": {
     "name": "PortOne",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portone/mcp-server",
-  "version": "0.15.0-alpha.3",
+  "version": "0.15.0-alpha.5",
   "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.15.0-alpha.3",
+  version: "0.15.0-alpha.5",
   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",
@@ -1058,12 +1058,39 @@ __export(getDocsUrl_exports, {
 import z8 from "zod";
 
 // src/tools/utils/docPathToUrl.ts
+var overridenPaths = /* @__PURE__ */ new Map([
+  [
+    "sdk/ko/v2-server-sdk/javascript",
+    "https://github.com/portone-io/server-sdk/tree/main/javascript#readme"
+  ],
+  [
+    "sdk/ko/v2-server-sdk/python",
+    "https://github.com/portone-io/server-sdk/tree/main/python#readme"
+  ],
+  [
+    "sdk/ko/v2-server-sdk/jvm",
+    "https://github.com/portone-io/server-sdk/tree/main/jvm#readme"
+  ],
+  [
+    "sdk/ko/v2-mobile-sdk/android",
+    "https://github.com/portone-io/android-sdk/tree/main#readme"
+  ],
+  [
+    "sdk/ko/v2-mobile-sdk/react-native",
+    "https://github.com/portone-io/react-native-sdk/tree/main#readme"
+  ]
+]);
 function docPathToUrl(path) {
-  if (path.startsWith("help/")) {
-    const slug = path.slice(path.lastIndexOf("/") + 1, -3);
+  const withoutMd = path.endsWith(".md") ? path.slice(0, -3) : path;
+  const overriden = overridenPaths.get(withoutMd);
+  if (overriden != null) {
+    return overriden;
+  }
+  if (withoutMd.startsWith("help/")) {
+    const slug = withoutMd.slice(path.lastIndexOf("/") + 1);
     return `${HELP_CENTER_URL}/content/${slug}`;
   }
-  return `${DEVELOPERS_URL}/${path}`;
+  return `${DEVELOPERS_URL}/${withoutMd}`;
 }
 
 // src/tools/getDocsUrl.ts
@@ -2239,13 +2266,17 @@ function init10(schema) {
     try {
       const pruned_data = pruneYaml(schemaData, 3);
       const yamlOutput = stringifyYaml(pruned_data);
+      const structuredContent = {
+        result: yamlOutput
+      };
       return {
         content: [
           {
             type: "text",
-            text: yamlOutput
+            text: JSON.stringify(structuredContent, null, 2)
           }
-        ]
+        ],
+        structuredContent
       };
     } catch (error) {
       return {
@@ -2286,9 +2317,6 @@ framework\uB97C \uC81C\uC678\uD55C \uBAA8\uB4E0 Args\uB294 \uC120\uD0DD\uC0AC\uD
       "\uC0AC\uC6A9\uD560 \uACB0\uC81C \uBC29\uBC95. \uC635\uC158: card, virtualAccount, easyPay, transfer, mobile, giftCertificate"
     ),
     smart_routing: z17.boolean().optional().describe("\uC2A4\uB9C8\uD2B8 \uB77C\uC6B0\uD305 \uC0AC\uC6A9 \uC5EC\uBD80. \uC635\uC158: true \uB610\uB294 false")
-  },
-  outputSchema: {
-    result: z17.string().describe("\uB9C8\uD06C\uB2E4\uC6B4 \uD615\uC2DD\uC758 \uBC31\uC5D4\uB4DC \uCF54\uB4DC \uC608\uC81C")
   }
 };
 function init11(apiBasePath) {
@@ -2318,17 +2346,13 @@ ${errorText}`
       }
       const data = await response.text();
       if (data) {
-        const structuredContent = {
-          result: data
-        };
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(structuredContent, null, 2)
+              text: data
             }
-          ],
-          structuredContent
+          ]
         };
       } else {
         return {
@@ -2380,9 +2404,6 @@ framework\uB97C \uC81C\uC678\uD55C \uBAA8\uB4E0 Args\uB294 \uC120\uD0DD\uC0AC\uD
       "\uC0AC\uC6A9\uD560 \uACB0\uC81C \uBC29\uBC95. \uC635\uC158: card, virtualAccount, easyPay, transfer, mobile, giftCertificate"
     ),
     smart_routing: z18.boolean().optional().describe("\uC2A4\uB9C8\uD2B8 \uB77C\uC6B0\uD305 \uC0AC\uC6A9 \uC5EC\uBD80. \uC635\uC158: true \uB610\uB294 false")
-  },
-  outputSchema: {
-    result: z18.string().describe("\uB9C8\uD06C\uB2E4\uC6B4 \uD615\uC2DD\uC758 \uD504\uB860\uD2B8\uC5D4\uB4DC \uCF54\uB4DC \uC608\uC81C")
   }
 };
 function init12(apiBasePath) {
@@ -2412,17 +2433,13 @@ ${errorText}`
       }
       const data = await response.text();
       if (data) {
-        const structuredContent = {
-          result: data
-        };
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(structuredContent, null, 2)
+              text: data
             }
-          ],
-          structuredContent
+          ]
         };
       } else {
         return {
@@ -2562,11 +2579,6 @@ max(0, idx - contextSize)\uBD80\uD130 min(contentLength, idx + len(query) + cont
     showMetadata: z19.boolean().default(false).describe(
       "true\uC774\uBA74 \uBB38\uC11C\uC758 \uBA54\uD0C0\uB370\uC774\uD130(\uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804)\uC744 \uACB0\uACFC\uC5D0 \uD3EC\uD568\uD569\uB2C8\uB2E4."
     )
-  },
-  outputSchema: {
-    result: z19.string().describe(
-      `\uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uB97C \uCC3E\uC73C\uBA74 \uD574\uB2F9 \uBB38\uC11C\uC758 \uACBD\uB85C\uC640 \uAE38\uC774, \uBA54\uD0C0\uB370\uC774\uD130, query\uAC00 \uB9E4\uCE6D\uB41C \uC8FC\uBCC0 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.`
-    )
   }
 };
 function formatOccurrence(occurrence) {
@@ -2682,17 +2694,14 @@ ${result}`;
           const truncationMsg = `
 
 ... (output truncated due to length limit. Use page: ${page + 1} for next page)`;
-          const structuredContent = {
-            result: fullResult.substring(0, limit) + truncationMsg
-          };
+          const truncatedResult = fullResult.substring(0, limit) + truncationMsg;
           return {
             content: [
               {
                 type: "text",
-                text: JSON.stringify(structuredContent, null, 2)
+                text: truncatedResult
               }
-            ],
-            structuredContent
+            ]
           };
         }
         return {