feat(mcp-cafe24-admin): add label tools

Author: gracefullight

packages/mcp-cafe24-admin/src/schemas/label.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+
+export const LabelsSearchParamsSchema = z
+  .object({
+    shop_no: z.number().min(1).default(1).describe("Shop Number"),
+    limit: z.number().min(1).max(1000).default(100).describe("Limit the number of results"),
+    offset: z.number().max(15000).default(0).describe("Start location of list"),
+  })
+  .strict();
+
+export const LabelsCreateParamsSchema = z
+  .object({
+    shop_no: z.number().min(1).default(1).describe("Shop Number"),
+    requests: z
+      .array(
+        z.object({
+          name: z.string().describe("Order label name"),
+          order_item_code: z.array(z.string()).describe("Order item code"),
+        }),
+      )
+      .describe("Listing of label requests"),
+  })
+  .strict();

packages/mcp-cafe24-admin/src/tools/index.ts

@@ -21,6 +21,7 @@ import { registerTools as registerFulfillmentTools } from "./fulfillment.js";
 import { registerTools as registerImageTools } from "./image.js";
 import { registerTools as registerInformationTools } from "./information.js";
 import { registerTools as registerKakaoTools } from "./kakao.js";
+import { registerTools as registerLabelTools } from "./label.js";
 import { registerTools as registerMainTools } from "./main.js";
 import { registerTools as registerMainProductsTools } from "./mainproducts.js";
 import { registerTools as registerMenuTools } from "./menu.js";
@@ -91,6 +92,7 @@ export function registerAllTools(server: McpServer): void {
   registerImageTools(server);
   registerInformationTools(server);
   registerKakaoTools(server);
+  registerLabelTools(server);
   registerMainTools(server);
   registerMainProductsTools(server);
   registerMenuTools(server);

packages/mcp-cafe24-admin/src/tools/label.ts

@@ -0,0 +1,89 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { z } from "zod";
+import type { LabelsCreateResponse, LabelsListResponse } from "@/types/index.js";
+import { LabelsCreateParamsSchema, LabelsSearchParamsSchema } from "../schemas/label.js";
+import { handleApiError, makeApiRequest } from "../services/api-client.js";
+
+async function cafe24_list_labels(params: z.infer<typeof LabelsSearchParamsSchema>) {
+  try {
+    const data = await makeApiRequest<LabelsListResponse>("/admin/labels", "GET", undefined, {
+      shop_no: params.shop_no,
+      limit: params.limit,
+      offset: params.offset,
+    });
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text:
+            `# Order Labels (Shop: ${data.labels.shop_no})\n\n` +
+            data.labels.names.map((name) => `- ${name}`).join("\n"),
+        },
+      ],
+      structuredContent: {
+        labels: data.labels,
+        links: data.links,
+      },
+    };
+  } catch (error) {
+    return { content: [{ type: "text" as const, text: handleApiError(error) }] };
+  }
+}
+
+async function cafe24_create_labels(params: z.infer<typeof LabelsCreateParamsSchema>) {
+  try {
+    const data = await makeApiRequest<LabelsCreateResponse>("/admin/labels", "POST", {
+      shop_no: params.shop_no,
+      requests: params.requests,
+    });
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `Successfully created ${data.labels.length} label(s).`,
+        },
+      ],
+      structuredContent: {
+        results: data.labels,
+      },
+    };
+  } catch (error) {
+    return { content: [{ type: "text" as const, text: handleApiError(error) }] };
+  }
+}
+
+export function registerTools(server: McpServer): void {
+  server.registerTool(
+    "cafe24_list_labels",
+    {
+      title: "List Cafe24 Order Labels",
+      description: "Retrieve a list of order labels for a specific shop.",
+      inputSchema: LabelsSearchParamsSchema,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+      },
+    },
+    cafe24_list_labels,
+  );
+
+  server.registerTool(
+    "cafe24_create_labels",
+    {
+      title: "Create Cafe24 Order Labels",
+      description: "Creates multiple labels for order items in a specific shop.",
+      inputSchema: LabelsCreateParamsSchema,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+      },
+    },
+    cafe24_create_labels,
+  );
+}

packages/mcp-cafe24-admin/src/types/index.ts

@@ -7,6 +7,7 @@ export * from "./customer.js";
 export * from "./exchange.js";
 export * from "./exchange-request.js";
 export * from "./fulfillment.js";
+export * from "./label.js";
 export * from "./marketing.js";
 export * from "./order.js";
 export * from "./order-control.js";

packages/mcp-cafe24-admin/src/types/label.ts

@@ -0,0 +1,25 @@
+export interface LabelsListResponse {
+  labels: {
+    shop_no: number;
+    names: string[];
+  };
+  links?: Array<{
+    rel: string;
+    href: string;
+  }>;
+}
+
+export interface LabelRequest {
+  name: string;
+  order_item_code: string[];
+}
+
+export interface Label {
+  shop_no: number;
+  name: string;
+  order_item_code: string[];
+}
+
+export interface LabelsCreateResponse {
+  labels: Label[];
+}