@sgrsoft/page24-mcp-server 0.1.0

package/dist/api-client.d.ts

@@ -0,0 +1,13 @@
+export interface ApiResponse<T = any> {
+    code: number;
+    message: string | null;
+    result: T;
+}
+export declare class Page24ApiClient {
+    private client;
+    private siteId;
+    constructor(apiUrl: string, apiKey: string, siteId: string);
+    get<T = any>(path: string, params?: Record<string, any>): Promise<ApiResponse<T>>;
+    post<T = any>(path: string, data?: Record<string, any>): Promise<ApiResponse<T>>;
+    getSiteId(): string;
+}

package/dist/api-client.js

@@ -0,0 +1,32 @@
+import axios from "axios";
+export class Page24ApiClient {
+    client;
+    siteId;
+    constructor(apiUrl, apiKey, siteId) {
+        this.siteId = siteId;
+        this.client = axios.create({
+            baseURL: apiUrl,
+            headers: {
+                "x-p24-api-key": apiKey,
+                "Content-Type": "application/json",
+            },
+            timeout: 30000,
+        });
+    }
+    async get(path, params = {}) {
+        const res = await this.client.get(path, {
+            params: { siteId: this.siteId, ...params },
+        });
+        return res.data;
+    }
+    async post(path, data = {}) {
+        const res = await this.client.post(path, {
+            siteId: this.siteId,
+            ...data,
+        });
+        return res.data;
+    }
+    getSiteId() {
+        return this.siteId;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,27 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Page24ApiClient } from "./api-client.js";
+import { registerPostTools } from "./tools/posts.js";
+import { registerMenuTools } from "./tools/menus.js";
+import { registerSiteTools } from "./tools/site.js";
+import { registerMemberTools } from "./tools/members.js";
+import { registerFormTools } from "./tools/forms.js";
+export function createServer() {
+    const apiUrl = process.env.PAGE24_API_URL;
+    const apiKey = process.env.PAGE24_API_KEY;
+    const siteId = process.env.PAGE24_SITE_ID;
+    if (!apiUrl || !apiKey || !siteId) {
+        console.error("환경변수가 설정되지 않았습니다: PAGE24_API_URL, PAGE24_API_KEY, PAGE24_SITE_ID");
+        process.exit(1);
+    }
+    const api = new Page24ApiClient(apiUrl, apiKey, siteId);
+    const server = new McpServer({
+        name: "page24",
+        version: "0.1.0",
+    });
+    registerMenuTools(server, api);
+    registerPostTools(server, api);
+    registerSiteTools(server, api);
+    registerMemberTools(server, api);
+    registerFormTools(server, api);
+    return server;
+}

package/dist/tools/forms.d.ts

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

package/dist/tools/forms.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export function registerFormTools(server, api) {
+    server.tool("list_form_submissions", "폼(문의/신청) 응답 목록을 조회합니다.", {
+        mcode: z.string().describe("폼이 속한 메뉴 코드"),
+        pageNo: z.number().optional().default(1).describe("페이지 번호"),
+        limit: z.number().optional().default(20).describe("페이지당 개수"),
+    }, async ({ mcode, pageNo, limit }) => {
+        const res = await api.get("/form/list", { mcode, pageNo, limit });
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(res.result, null, 2) }] };
+    });
+}

package/dist/tools/members.d.ts

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

package/dist/tools/members.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export function registerMemberTools(server, api) {
+    server.tool("list_members", "사이트 회원 목록을 조회합니다.", {
+        pageNo: z.number().optional().default(1).describe("페이지 번호"),
+        limit: z.number().optional().default(20).describe("페이지당 개수"),
+        keyword: z.string().optional().describe("검색어 (닉네임, 아이디)"),
+    }, async ({ pageNo, limit, keyword }) => {
+        const res = await api.get("/member/memberManageList", {
+            pageNo,
+            limit,
+            keyword: keyword || "",
+        });
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(res.result, null, 2) }] };
+    });
+}

package/dist/tools/menus.d.ts

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

package/dist/tools/menus.js

@@ -0,0 +1,19 @@
+export function registerMenuTools(server, api) {
+    server.tool("list_menus", "사이트의 메뉴(페이지) 목록을 조회합니다. 각 메뉴의 mcode를 확인할 수 있습니다.", {}, async () => {
+        const res = await api.get("/menu/listAll");
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        const menus = res.result;
+        const summary = Array.isArray(menus)
+            ? menus.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) }] };
+    });
+}

package/dist/tools/posts.d.ts

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

package/dist/tools/posts.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+export function registerPostTools(server, api) {
+    server.tool("list_posts", "게시글 목록을 조회합니다. mcode(메뉴코드)가 필요합니다. list_menus로 먼저 메뉴 목록을 확인하세요.", {
+        mcode: z.string().describe("메뉴 코드 (list_menus로 확인)"),
+        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 res = await api.get("/board/List", {
+            mcode,
+            pageNo,
+            limit,
+            keyword: keyword || "",
+        });
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(res.result, null, 2) }] };
+    });
+    server.tool("get_post", "게시글 상세 내용을 조회합니다.", {
+        mcode: z.string().describe("메뉴 코드"),
+        board_id: z.number().describe("게시글 번호"),
+    }, async ({ mcode, board_id }) => {
+        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("메뉴 코드"),
+        title: z.string().describe("게시글 제목"),
+        content: z.string().describe("게시글 내용 (HTML)"),
+        category: z.string().optional().describe("카테고리"),
+    }, async ({ mcode, title, content, category }) => {
+        const data = { mcode, title, content };
+        if (category)
+            data.category = category;
+        const res = await api.post("/board/write", data);
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        return { content: [{ type: "text", text: `게시글 작성 완료: ${JSON.stringify(res.result)}` }] };
+    });
+    server.tool("update_post", "기존 게시글을 수정합니다. (readwrite 권한 필요)", {
+        mcode: z.string().describe("메뉴 코드"),
+        board_id: z.number().describe("게시글 번호"),
+        title: z.string().optional().describe("수정할 제목"),
+        content: z.string().optional().describe("수정할 내용 (HTML)"),
+    }, async ({ mcode, board_id, title, content }) => {
+        const data = { mcode, board_id };
+        if (title)
+            data.title = title;
+        if (content)
+            data.content = content;
+        const res = await api.post("/board/update", data);
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        return { content: [{ type: "text", text: `게시글 수정 완료: ${JSON.stringify(res.result)}` }] };
+    });
+    server.tool("delete_post", "게시글을 삭제합니다. (readwrite 권한 필요)", {
+        mcode: z.string().describe("메뉴 코드"),
+        board_id: z.number().describe("게시글 번호"),
+    }, async ({ mcode, board_id }) => {
+        const res = await api.post("/board/delete", { mcode, board_id });
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        return { content: [{ type: "text", text: `게시글 삭제 완료` }] };
+    });
+}

package/dist/tools/site.d.ts

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

package/dist/tools/site.js

@@ -0,0 +1,11 @@
+export function registerSiteTools(server, api) {
+    server.tool("get_site_config", "사이트 설정 정보를 조회합니다.", {}, async () => {
+        const res = await api.get("/siteConfig/info", {
+            hostid: api.getSiteId(),
+        });
+        if (res.code !== 200) {
+            return { content: [{ type: "text", text: `오류: ${res.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(res.result, null, 2) }] };
+    });
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@sgrsoft/page24-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for page24 CMS",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "page24-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "axios": "^1.7.9",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "tsx": "^4.19.0",
+    "@types/node": "^22.0.0"
+  },
+  "files": ["dist"],
+  "license": "MIT"
+}