@ncds/ui-admin-mcp 1.0.0-alpha.2 → 1.0.0-alpha.4

package/bin/definitions/instructions.md

@@ -38,7 +38,8 @@ You are an agent that builds UI using NCUA (NCDS UI Admin) design system compone
 
 ### Step 3: HTML Generation
 
-- Use **render_to_html** to get the exact HTML for each component
+- When building a page with multiple components, use **render_to_html_batch** to render them all in one call (max 30). This is much more efficient than calling render_to_html repeatedly.
+- For a single component, use **render_to_html**.
 - Use the returned html as-is. Do NOT modify class names, structure, or attributes.
 
 ### Step 4: CDN Inclusion

package/bin/definitions/rules.json

@@ -3,7 +3,8 @@
     "You MUST generate component HTML using the render_to_html tool. Never write HTML/CSS manually.",
     "Use the HTML returned by render_to_html as-is. Do NOT modify class names, structure, or attributes.",
     "Use search_component to find the right component by Korean/English keywords before building any UI.",
-    "Use list_components to browse available components by category and choose the appropriate one."
+    "Use list_components to browse available components by category and choose the appropriate one.",
+    "When building a page with multiple components, use render_to_html_batch to render them all in one call instead of calling render_to_html repeatedly."
   ],
   "componentSelection": [
     "For password fields, you MUST use password-input. The input component is for plain text only.",

package/bin/definitions/tool-definitions.json

@@ -24,6 +24,9 @@
     "render_to_html": {
       "description": "Generate exact HTML for an NCUA component with given props. Returns html, appliedProps, defaultsUsed, js, cdn."
     },
+    "render_to_html_batch": {
+      "description": "Render multiple NCUA components in a single call (max 30). Pass an array of {name, props} objects. Returns an array of render results. Use this instead of calling render_to_html repeatedly when building a page."
+    },
     "get_design_tokens": {
       "description": "Get available design tokens (CSS variables) for colors, typography, spacing, and shadows. Use when building custom areas to pick real tokens instead of guessing."
     }
@@ -37,6 +40,7 @@
     { "tool": "get_component_props", "description": "Get component props spec" },
     { "tool": "validate_html", "description": "Validate HTML BEM classes + design system compliance score + auto-fix" },
     { "tool": "render_to_html", "description": "Props-based dynamic HTML rendering" },
+    { "tool": "render_to_html_batch", "description": "Batch render multiple components in one call (max 30)" },
     { "tool": "get_design_tokens", "description": "Design token (CSS variable) lookup by category" }
   ]
 }

package/bin/server.js

@@ -23,6 +23,7 @@ const ping_js_1 = require("./tools/ping.js");
 const listIcons_js_1 = require("./tools/listIcons.js");
 const searchIcon_js_1 = require("./tools/searchIcon.js");
 const renderToHtml_js_1 = require("./tools/renderToHtml.js");
+const response_js_1 = require("./utils/response.js");
 const getDesignTokens_js_1 = require("./tools/getDesignTokens.js");
 const version_js_1 = require("./version.js");
 const domEnvironment_js_1 = require("./utils/domEnvironment.js");
@@ -145,6 +146,34 @@ const main = async () => {
         name,
         props: props,
     }));
+    server.registerTool('render_to_html_batch', {
+        description: descriptions['render_to_html_batch'],
+        inputSchema: {
+            components: zod_1.z
+                .array(zod_1.z.object({
+                name: zod_1.z.string().min(1).describe('Component name'),
+                props: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional().describe('Component props'),
+            }))
+                .min(1)
+                .max(30)
+                .describe('Array of components to render (max 30)'),
+        },
+    }, ({ components }) => {
+        const results = components.map(({ name, props }) => (0, renderToHtml_js_1.renderToHtml)({
+            componentMap,
+            bundle,
+            cdnMeta,
+            iconMeta,
+            reactRuntime,
+            name,
+            props: props,
+        }));
+        const parsed = results.map((r) => {
+            const text = r.content[0].text;
+            return r.isError ? { error: JSON.parse(text) } : JSON.parse(text);
+        });
+        return (0, response_js_1.successResponse)(parsed);
+    });
     server.registerTool('get_design_tokens', {
         description: descriptions['get_design_tokens'],
         inputSchema: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ncds/ui-admin-mcp",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.4",
   "description": "NCDS UI Admin MCP 서버 — AI 에이전트가 NCUA 컴포넌트를 조회하고 HTML을 검증할 수 있는 MCP 서버",
   "bin": {
     "ncua-mcp": "./bin/server.mjs"
@@ -41,28 +41,12 @@
     "node-html-parser": "^7.1.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "zod": "^4.3.6"
-  },
-  "peerDependencies": {
+    "zod": "^4.3.6",
     "flatpickr": ">=4.6.0",
     "lodash-es": ">=4.17.0",
     "moment": ">=2.30.0",
     "swiper": ">=11.0.0"
   },
-  "peerDependenciesMeta": {
-    "flatpickr": {
-      "optional": true
-    },
-    "lodash-es": {
-      "optional": true
-    },
-    "moment": {
-      "optional": true
-    },
-    "swiper": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@types/node": "^25.5.0",
     "@types/react": "^18.3.20",