@sgrsoft/page24-mcp-server 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,6 @@
+## page24-mcp
+> Creator: page24@sgrsoft.com
+> Date: 2026/03/25
+
+## Description 
+* page24-mcp에 대한 설명을 작성하세요

package/dist/server.js

@@ -5,6 +5,7 @@ import { registerMenuTools } from "./tools/menus.js";
 import { registerSiteTools } from "./tools/site.js";
 import { registerMemberTools } from "./tools/members.js";
 import { registerFormTools } from "./tools/forms.js";
+import { registerAnalyticsTools } from "./tools/analytics.js";
 export function createServer() {
     const apiUrl = process.env.PAGE24_API_URL;
     const apiKey = process.env.PAGE24_API_KEY;
@@ -23,5 +24,6 @@ export function createServer() {
     registerSiteTools(server, api);
     registerMemberTools(server, api);
     registerFormTools(server, api);
+    registerAnalyticsTools(server, api);
     return server;
 }

package/dist/tools/analytics.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Page24ApiClient } from "../api-client.js";
+export declare function registerAnalyticsTools(server: McpServer, api: Page24ApiClient): void;

package/dist/tools/analytics.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export function registerAnalyticsTools(server, api) {
+    server.tool("get_visitor_stats", "사이트 방문자 통계를 조회합니다. 날짜별 PV(페이지뷰)와 UV(순방문자)를 확인할 수 있습니다.", {
+        start_date: z.string().describe("시작일 (YYYY-MM-DD)"),
+        end_date: z.string().describe("종료일 (YYYY-MM-DD)"),
+        mcode: z.string().optional().describe("특정 메뉴의 통계만 조회 (4자리 이상 메뉴코드)"),
+    }, async ({ start_date, end_date, mcode }) => {
+        const params = {
+            hostid: api.getSiteId(),
+            start_date,
+            end_date,
+        };
+        if (mcode)
+            params.mcode = mcode;
+        const res = await api.get("/log/visitLogStat", params);
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        const result = res.result;
+        const summary = [
+            `📊 방문자 통계 (${start_date} ~ ${end_date})`,
+            ``,
+            `총 페이지뷰(PV): ${result.total_pv_cnt}`,
+            `총 순방문자(UV): ${result.total_uv_cnt}`,
+            `일 평균 PV: ${result.avg_pv_cnt}`,
+            `일 평균 UV: ${result.avg_uv_cnt}`,
+            `최대 일 PV: ${result.max_pv_cnt}`,
+            `최대 일 UV: ${result.max_uv_cnt}`,
+            ``,
+            `📅 일별 상세:`,
+            ...(Array.isArray(result.list)
+                ? result.list.map((d) => `  ${d.date}  PV: ${d.pv_cnt}  UV: ${d.uv_cnt}`)
+                : []),
+        ];
+        return { content: [{ type: "text", text: summary.join("\n") }] };
+    });
+}

package/dist/tools/menus.js

@@ -5,15 +5,31 @@ export function registerMenuTools(server, api) {
             return { content: [{ type: "text", text: `오류: ${res.message}` }] };
         }
         const menus = res.result;
-        const summary = Array.isArray(menus)
-            ? menus.map((m) => ({
+        if (!Array.isArray(menus)) {
+            return { content: [{ type: "text", text: JSON.stringify(menus, null, 2) }] };
+        }
+        // 1뎁스: 2자리 mcode (하위 분류용), 2뎁스: 4자리 mcode (실제 기능 메뉴)
+        const topMenus = menus.filter((m) => m.mcode.length === 2);
+        const tree = topMenus.map((parent) => {
+            const children = menus
+                .filter((m) => m.scode === parent.mcode && m.mcode.length >= 4)
+                .map((m) => ({
                 mcode: m.mcode,
                 title: m.title,
                 type: m.type,
                 state: m.state,
-                scode: m.scode,
-            }))
-            : menus;
-        return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+            }));
+            return {
+                mcode: parent.mcode,
+                title: parent.title,
+                note: "하위분류용(게시글 작성 불가)",
+                children,
+            };
+        });
+        const boards = menus.filter((m) => m.mcode.length >= 4 && m.type === "board");
+        const hint = boards.length > 0
+            ? `\n\n📌 게시글 작성 가능한 게시판 메뉴:\n${boards.map((b) => `  - ${b.mcode}: ${b.title}`).join("\n")}`
+            : "\n\n⚠️ 게시판(type='board') 메뉴가 없습니다.";
+        return { content: [{ type: "text", text: JSON.stringify(tree, null, 2) + hint }] };
     });
 }

package/dist/tools/posts.js

@@ -1,11 +1,20 @@
 import { z } from "zod";
+function validateMcode(mcode) {
+    if (mcode.length < 4) {
+        return `오류: mcode '${mcode}'는 ${mcode.length}자리입니다. 2자리 메뉴는 하위 분류용이므로 게시글을 작성할 수 없습니다. 4자리 이상의 메뉴코드(type이 'board'인 메뉴)를 사용하세요. list_menus로 사용 가능한 게시판 메뉴를 확인하세요.`;
+    }
+    return null;
+}
 export function registerPostTools(server, api) {
-    server.tool("list_posts", "게시글 목록을 조회합니다. mcode(메뉴코드)가 필요합니다. list_menus로 먼저 메뉴 목록을 확인하세요.", {
-        mcode: z.string().describe("메뉴 코드 (list_menus로 확인)"),
+    server.tool("list_posts", "게시글 목록을 조회합니다. mcode는 반드시 4자리 이상이어야 합니다(2자리는 하위 분류용). list_menus로 먼저 type이 'board'인 메뉴의 mcode를 확인하세요.", {
+        mcode: z.string().min(4).describe("메뉴 코드 (4자리 이상, list_menus에서 type='board'인 메뉴)"),
         pageNo: z.number().optional().default(1).describe("페이지 번호"),
         limit: z.number().optional().default(10).describe("페이지당 개수"),
         keyword: z.string().optional().describe("검색어"),
     }, async ({ mcode, pageNo, limit, keyword }) => {
+        const err = validateMcode(mcode);
+        if (err)
+            return { content: [{ type: "text", text: err }] };
         const res = await api.get("/board/List", {
             mcode,
             pageNo,
@@ -17,22 +26,28 @@ export function registerPostTools(server, api) {
         }
         return { content: [{ type: "text", text: JSON.stringify(res.result, null, 2) }] };
     });
-    server.tool("get_post", "게시글 상세 내용을 조회합니다.", {
-        mcode: z.string().describe("메뉴 코드"),
+    server.tool("get_post", "게시글 상세 내용을 조회합니다. mcode는 4자리 이상이어야 합니다.", {
+        mcode: z.string().min(4).describe("메뉴 코드 (4자리 이상)"),
         board_id: z.number().describe("게시글 번호"),
     }, async ({ mcode, board_id }) => {
+        const err = validateMcode(mcode);
+        if (err)
+            return { content: [{ type: "text", text: err }] };
         const res = await api.get("/board/read", { mcode, board_id });
         if (res.code !== 200) {
             return { content: [{ type: "text", text: `오류: ${res.message}` }] };
         }
         return { content: [{ type: "text", text: JSON.stringify(res.result, null, 2) }] };
     });
-    server.tool("create_post", "새 게시글을 작성합니다. (readwrite 권한 필요)", {
-        mcode: z.string().describe("메뉴 코드"),
+    server.tool("create_post", "새 게시글을 작성합니다. (readwrite 권한 필요) mcode는 반드시 4자리 이상의 게시판(type='board') 메뉴코드여야 합니다. 2자리 메뉴는 하위 분류용이라 게시글 작성이 불가합니다.", {
+        mcode: z.string().min(4).describe("메뉴 코드 (4자리 이상, type='board'인 메뉴만 가능)"),
         title: z.string().describe("게시글 제목"),
         content: z.string().describe("게시글 내용 (HTML)"),
         category: z.string().optional().describe("카테고리"),
     }, async ({ mcode, title, content, category }) => {
+        const err = validateMcode(mcode);
+        if (err)
+            return { content: [{ type: "text", text: err }] };
         const data = { mcode, title, content };
         if (category)
             data.category = category;
@@ -42,12 +57,15 @@ export function registerPostTools(server, api) {
         }
         return { content: [{ type: "text", text: `게시글 작성 완료: ${JSON.stringify(res.result)}` }] };
     });
-    server.tool("update_post", "기존 게시글을 수정합니다. (readwrite 권한 필요)", {
-        mcode: z.string().describe("메뉴 코드"),
+    server.tool("update_post", "기존 게시글을 수정합니다. (readwrite 권한 필요) mcode는 4자리 이상이어야 합니다.", {
+        mcode: z.string().min(4).describe("메뉴 코드 (4자리 이상)"),
         board_id: z.number().describe("게시글 번호"),
         title: z.string().optional().describe("수정할 제목"),
         content: z.string().optional().describe("수정할 내용 (HTML)"),
     }, async ({ mcode, board_id, title, content }) => {
+        const err = validateMcode(mcode);
+        if (err)
+            return { content: [{ type: "text", text: err }] };
         const data = { mcode, board_id };
         if (title)
             data.title = title;
@@ -59,10 +77,13 @@ export function registerPostTools(server, api) {
         }
         return { content: [{ type: "text", text: `게시글 수정 완료: ${JSON.stringify(res.result)}` }] };
     });
-    server.tool("delete_post", "게시글을 삭제합니다. (readwrite 권한 필요)", {
-        mcode: z.string().describe("메뉴 코드"),
+    server.tool("delete_post", "게시글을 삭제합니다. (readwrite 권한 필요) mcode는 4자리 이상이어야 합니다.", {
+        mcode: z.string().min(4).describe("메뉴 코드 (4자리 이상)"),
         board_id: z.number().describe("게시글 번호"),
     }, async ({ mcode, board_id }) => {
+        const err = validateMcode(mcode);
+        if (err)
+            return { content: [{ type: "text", text: err }] };
         const res = await api.post("/board/delete", { mcode, board_id });
         if (res.code !== 200) {
             return { content: [{ type: "text", text: `오류: ${res.message}` }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sgrsoft/page24-mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for page24 CMS",
   "type": "module",
   "main": "dist/index.js",
@@ -10,7 +10,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/index.ts",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "release": "release-it"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
@@ -20,8 +21,14 @@
   "devDependencies": {
     "typescript": "^5.7.0",
     "tsx": "^4.19.0",
-    "@types/node": "^22.0.0"
+    "@types/node": "^22.0.0",
+    "release-it": "^18.1.0"
   },
-  "files": ["dist"],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
   "license": "MIT"
 }