@vadenai/mcp-server 0.2.1 → 0.3.0

package/dist/api-client.d.ts

@@ -12,4 +12,7 @@ export declare class VadenMcpApiClient {
     private headers;
     private buildUrl;
     get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
+    private request;
 }

package/dist/api-client.js

@@ -24,18 +24,28 @@ export class VadenMcpApiClient {
         return new URL(cleanPath, base).toString();
     }
     async get(path) {
+        return this.request("GET", path);
+    }
+    async post(path, body) {
+        return this.request("POST", path, body);
+    }
+    async patch(path, body) {
+        return this.request("PATCH", path, body);
+    }
+    async request(method, path, body) {
         const url = this.buildUrl(path);
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
         try {
             const response = await fetch(url, {
-                method: "GET",
+                method,
                 headers: this.headers(),
                 signal: controller.signal,
+                ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
             });
             if (!response.ok) {
-                const body = await response.text();
-                throw new Error(`API error (${response.status}): ${body}`);
+                const text = await response.text();
+                throw new Error(`API error (${response.status}): ${text}`);
             }
             return (await response.json());
         }

package/dist/index.js

@@ -13,11 +13,14 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { VadenMcpApiClient } from "./api-client.js";
 import { handleGetComponentList, handleGetComponentSpec, handleSearchComponents, } from "./tools/components.js";
-import { handleGetConcept, handleGetDesignRationale } from "./tools/concept.js";
+import { handleGetConcept, handleGetDesignRationale, handleUpdateConcept, } from "./tools/concept.js";
 import { handleGetDesignTokens, handleGetThemeCss, } from "./tools/design-tokens.js";
-import { handleGetWireframeDetail, handleGetWireframes, } from "./tools/wireframes.js";
+import { handleGetWireframeDetail, handleGetWireframes, handlePushWireframes, handleUpdateWireframe, } from "./tools/wireframes.js";
+import { handleUpdateComponentStyle } from "./tools/write-components.js";
+import { handleUpdateDesignTokens } from "./tools/write-tokens.js";
+import { validateArrayAddArgs, validateArrayRemoveArgs, validateFieldUpdateArgs, validatePushWireframesArgs, } from "./validation.js";
 // --- コマンドライン引数パース ---
-const VERSION = "0.2.1";
+const VERSION = "0.3.0";
 function parseArgs() {
     const args = process.argv.slice(2);
     if (args.includes("--help") || args.includes("-h")) {
@@ -159,6 +162,187 @@ const TOOLS = [
             required: [],
         },
     },
+    // --- Write ツール ---
+    {
+        name: "update_design_tokens",
+        description: "デザイントークン（色・spacing・radius等）を部分更新します。指定したフィールドのみ deep merge で上書きされます",
+        inputSchema: {
+            type: "object",
+            properties: {
+                tokens: {
+                    type: "object",
+                    description: "更新するトークン（deep merge）。例: { colors: { light: { semantic: { primary: '#3B82F6' } } } }",
+                },
+            },
+            required: ["tokens"],
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "update_component_style",
+        description: "指定したコンポーネントのスタイル設定をオーバーライドします。ベーススタイルは保持され、オーバーライドレイヤーとして保存されます",
+        inputSchema: {
+            type: "object",
+            properties: {
+                component: {
+                    type: "string",
+                    description: "コンポーネント名（例: button, card）",
+                },
+                updatedStyleConfig: {
+                    type: "object",
+                    description: "更新するスタイル設定。Single型: { baseStyles, variants }、Multipart型: { slots, variants }",
+                },
+            },
+            required: ["component", "updatedStyleConfig"],
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "update_concept",
+        description: "コンセプトの特定フィールドをドット区切りパスで更新します。例: serviceName, brandPersonality.0, targetUsers.2",
+        inputSchema: {
+            type: "object",
+            properties: {
+                field_path: {
+                    type: "string",
+                    description: "更新するフィールドのドット区切りパス（例: 'serviceName', 'brandPersonality.0'）",
+                },
+                value: {
+                    oneOf: [
+                        { type: "string" },
+                        { type: "number" },
+                        { type: "boolean" },
+                        { type: "null" },
+                    ],
+                    description: "新しい値（文字列・数値・真偽値・null）",
+                },
+            },
+            required: ["field_path", "value"],
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "update_wireframe",
+        description: "ワイヤーフレームの特定フィールドをドット区切りパスで更新します。例: screens.0.name, transitions.1.label",
+        inputSchema: {
+            type: "object",
+            properties: {
+                field_path: {
+                    type: "string",
+                    description: "更新するフィールドのドット区切りパス（例: 'screens.0.name'）",
+                },
+                value: {
+                    oneOf: [
+                        { type: "string" },
+                        { type: "number" },
+                        { type: "boolean" },
+                        { type: "null" },
+                    ],
+                    description: "新しい値（文字列・数値・真偽値・null）",
+                },
+            },
+            required: ["field_path", "value"],
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "add_wireframe_element",
+        description: "ワイヤーフレームの配列に要素を追加します。画面追加（screens）、コンポーネント追加（screens.0.components）、遷移追加（transitions）などに使用",
+        inputSchema: {
+            type: "object",
+            properties: {
+                field_path: {
+                    type: "string",
+                    description: "追加先の配列パス（例: 'screens', 'screens.0.components', 'transitions'）",
+                },
+                value: {
+                    type: "object",
+                    description: "追加する要素。画面: { id, name, purpose, width: 800, components: [], group?, journeyStage? }、コンポーネント: { id, type, label }、遷移: { id, fromScreenId, toScreenId, triggerAction?, label? }",
+                },
+            },
+            required: ["field_path", "value"],
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "remove_wireframe_element",
+        description: "ワイヤーフレームの配列から要素を削除します。画面削除（screens.2）、コンポーネント削除（screens.0.components.3）、遷移削除（transitions.1）などに使用",
+        inputSchema: {
+            type: "object",
+            properties: {
+                field_path: {
+                    type: "string",
+                    description: "削除する要素のパス（最後のセグメントが配列インデックス。例: 'screens.2', 'screens.0.components.3', 'transitions.1'）",
+                },
+            },
+            required: ["field_path"],
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "push_wireframes",
+        description: "UXIR（YAML形式）ファイルを一括プッシュしてワイヤーフレームを更新します。既存のワイヤーフレームは置換されます",
+        inputSchema: {
+            type: "object",
+            properties: {
+                files: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            filename: {
+                                type: "string",
+                                description: "ファイル名（.uxir 拡張子必須）",
+                            },
+                            content: {
+                                type: "string",
+                                description: "UXIR YAML コンテンツ",
+                            },
+                        },
+                        required: ["filename", "content"],
+                    },
+                    description: "UXIR ファイル一覧（最大50ファイル、各1MB以下）",
+                },
+            },
+            required: ["files"],
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    },
 ];
 // --- メイン ---
 async function main() {
@@ -171,6 +355,7 @@ async function main() {
             name: t.name,
             description: t.description,
             inputSchema: t.inputSchema,
+            ...("annotations" in t ? { annotations: t.annotations } : {}),
         })),
     }));
     // ツール呼び出し
@@ -225,6 +410,53 @@ async function main() {
                 const content = await handleGetDesignRationale(client, projectId);
                 return { content };
             }
+            // --- Write ツール ---
+            case "update_design_tokens": {
+                const tokens = args?.tokens;
+                if (!tokens || typeof tokens !== "object") {
+                    throw new Error("tokens パラメータが必要です（オブジェクト）");
+                }
+                const content = await handleUpdateDesignTokens(client, projectId, tokens);
+                return { content };
+            }
+            case "update_component_style": {
+                const componentName = String(args?.component ?? "");
+                const updatedStyleConfig = args
+                    ?.updatedStyleConfig;
+                if (!componentName) {
+                    throw new Error("component パラメータが必要です");
+                }
+                if (!updatedStyleConfig || typeof updatedStyleConfig !== "object") {
+                    throw new Error("updatedStyleConfig パラメータが必要です（オブジェクト）");
+                }
+                const content = await handleUpdateComponentStyle(client, projectId, componentName, updatedStyleConfig);
+                return { content };
+            }
+            case "update_concept": {
+                const { fieldPath, value } = validateFieldUpdateArgs(args);
+                const content = await handleUpdateConcept(client, projectId, fieldPath, value);
+                return { content };
+            }
+            case "update_wireframe": {
+                const { fieldPath, value } = validateFieldUpdateArgs(args);
+                const content = await handleUpdateWireframe(client, projectId, fieldPath, value);
+                return { content };
+            }
+            case "add_wireframe_element": {
+                const { fieldPath, value } = validateArrayAddArgs(args);
+                const content = await handleUpdateWireframe(client, projectId, fieldPath, value, "add");
+                return { content };
+            }
+            case "remove_wireframe_element": {
+                const { fieldPath } = validateArrayRemoveArgs(args);
+                const content = await handleUpdateWireframe(client, projectId, fieldPath, null, "remove");
+                return { content };
+            }
+            case "push_wireframes": {
+                const validatedFiles = validatePushWireframesArgs(args);
+                const content = await handlePushWireframes(client, projectId, validatedFiles);
+                return { content };
+            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/dist/tools/concept.d.ts

@@ -4,6 +4,18 @@
  * コンセプト API: GET /api/projects/{projectId}/concept
  */
 import type { VadenMcpApiClient } from "../api-client.js";
+/**
+ * コンセプトの特定フィールドを更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param fieldPath - ドット区切りのフィールドパス（例: 'brandPersonality.0', 'serviceName'）
+ * @param value - 新しい値
+ */
+export declare function handleUpdateConcept(client: VadenMcpApiClient, projectId: string, fieldPath: string, value: unknown, operation?: "update" | "add" | "remove"): Promise<{
+    type: "text";
+    text: string;
+}[]>;
 /**
  * コンセプト情報を返す
  *

package/dist/tools/concept.js

@@ -48,6 +48,24 @@ function generateConceptGuide(data) {
         }
         lines.push("");
     }
+    if (data.colorEmotions) {
+        lines.push("## Color Emotions");
+        lines.push("");
+        if (data.colorEmotions.primary) {
+            lines.push(`**Primary**: ${data.colorEmotions.primary}`);
+        }
+        if (data.colorEmotions.secondary) {
+            lines.push(`**Secondary**: ${data.colorEmotions.secondary}`);
+        }
+        if (data.colorEmotions.emotional?.length) {
+            lines.push("");
+            lines.push("### Emotional Effects");
+            for (const effect of data.colorEmotions.emotional) {
+                lines.push(`- ${effect}`);
+            }
+        }
+        lines.push("");
+    }
     lines.push("## Design Principles");
     lines.push("");
     for (const principle of data.designPrinciples) {
@@ -66,6 +84,32 @@ function generateConceptGuide(data) {
         lines.push(`- ${journey}`);
     }
     lines.push("");
+    if (data.layoutPatterns?.length) {
+        lines.push("## Layout Patterns");
+        lines.push("");
+        for (const pattern of data.layoutPatterns) {
+            lines.push(`### ${pattern.name}`);
+            lines.push("");
+            lines.push(pattern.description);
+            if (pattern.basedOn) {
+                if (pattern.basedOn.interfaceApproach?.length) {
+                    lines.push(`- **Interface Approach**: ${pattern.basedOn.interfaceApproach.join(", ")}`);
+                }
+                if (pattern.basedOn.layoutStrategy?.length) {
+                    lines.push(`- **Layout Strategy**: ${pattern.basedOn.layoutStrategy.join(", ")}`);
+                }
+            }
+            if (pattern.specs) {
+                if (pattern.specs.grid) {
+                    lines.push(`- **Grid**: ${pattern.specs.grid.columns ?? "?"}col, gap ${String(pattern.specs.grid.gap ?? "?")}`);
+                }
+                if (pattern.specs.nav?.type) {
+                    lines.push(`- **Navigation**: ${pattern.specs.nav.type}`);
+                }
+            }
+            lines.push("");
+        }
+    }
     lines.push("> Use `get_design_rationale` to understand the reasoning behind design decisions.");
     return lines.join("\n");
 }
@@ -120,6 +164,86 @@ function generateDesignRationaleGuide(data) {
         lines.push(`- ${principle}`);
     }
     lines.push("");
+    if (da.visualEffects?.length) {
+        lines.push("## Visual Effects");
+        lines.push("");
+        for (const effect of da.visualEffects) {
+            lines.push(`- **${effect.name}**: ${effect.intent}`);
+        }
+        lines.push("");
+    }
+    if (da.interactionDesign?.length) {
+        lines.push("## Interaction Design");
+        lines.push("");
+        for (const item of da.interactionDesign) {
+            lines.push(`- **${item.feature}**: ${item.purpose}`);
+        }
+        lines.push("");
+    }
+    if (da.layoutStrategy?.length) {
+        lines.push("## Layout Strategy");
+        lines.push("");
+        for (const item of da.layoutStrategy) {
+            lines.push(`- **${item.aspect}**: ${item.rationale}`);
+        }
+        lines.push("");
+    }
+    if (da.motionDesign?.length) {
+        lines.push("## Motion Design");
+        lines.push("");
+        for (const item of da.motionDesign) {
+            lines.push(`- ${item}`);
+        }
+        lines.push("");
+    }
+    if (da.differentiation?.length) {
+        lines.push("## Differentiation");
+        lines.push("");
+        for (const item of da.differentiation) {
+            lines.push(`- vs **${item.competitor}**: ${item.distinction}`);
+        }
+        lines.push("");
+    }
+    if (da.behavioralPsychology?.length) {
+        lines.push("## Behavioral Psychology");
+        lines.push("");
+        for (const item of da.behavioralPsychology) {
+            lines.push(`- **${item.principle}**: ${item.application}`);
+        }
+        lines.push("");
+    }
+    if (da.iconography?.length) {
+        lines.push("## Iconography");
+        lines.push("");
+        for (const item of da.iconography) {
+            lines.push(`- **${item.element}**: ${item.symbolism}`);
+        }
+        lines.push("");
+    }
+    if (da.culturalResonance?.length) {
+        lines.push("## Cultural Resonance");
+        lines.push("");
+        for (const item of da.culturalResonance) {
+            lines.push(`- ${item}`);
+        }
+        lines.push("");
+    }
+    if (da.informationArchitecture?.length) {
+        lines.push("## Information Architecture");
+        lines.push("");
+        for (const item of da.informationArchitecture) {
+            lines.push(`- ${item}`);
+        }
+        lines.push("");
+    }
+    if (da.brandConsistency?.length) {
+        lines.push("## Brand Consistency");
+        lines.push("");
+        for (const item of da.brandConsistency) {
+            lines.push(`- ${item}`);
+        }
+        lines.push("");
+    }
     lines.push("## Success Metrics");
     lines.push("");
     for (const metric of data.successMetrics) {
@@ -134,7 +258,29 @@ function generateDesignRationaleGuide(data) {
     lines.push("");
     return lines.join("\n");
 }
-// --- ツールハンドラー ---
+/**
+ * コンセプトの特定フィールドを更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param fieldPath - ドット区切りのフィールドパス（例: 'brandPersonality.0', 'serviceName'）
+ * @param value - 新しい値
+ */
+export async function handleUpdateConcept(client, projectId, fieldPath, value, operation = "update") {
+    await client.patch(`/api/projects/${encodeURIComponent(projectId)}/concept`, { fieldPath, value, operation });
+    const actionLabel = operation === "add"
+        ? "added to"
+        : operation === "remove"
+            ? "removed from"
+            : "updated in";
+    return [
+        {
+            type: "text",
+            text: `Concept: element ${actionLabel} "${fieldPath}"${operation !== "remove" ? ` — ${JSON.stringify(value)}` : ""}`,
+        },
+    ];
+}
+// --- Read ハンドラー ---
 /**
  * コンセプト情報を返す
  *

package/dist/tools/wireframes.d.ts

@@ -5,6 +5,32 @@
  * 画面詳細 API: GET /api/projects/{projectId}/wireframe/{screenId}
  */
 import type { VadenMcpApiClient } from "../api-client.js";
+/**
+ * ワイヤーフレームの特定フィールドを更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param fieldPath - ドット区切りのフィールドパス（例: 'screens.0.name'）
+ * @param value - 新しい値
+ */
+export declare function handleUpdateWireframe(client: VadenMcpApiClient, projectId: string, fieldPath: string, value: unknown, operation?: "update" | "add" | "remove"): Promise<{
+    type: "text";
+    text: string;
+}[]>;
+/**
+ * UXIR ファイルを一括プッシュしてワイヤーフレームを更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param files - UXIR ファイル一覧 [{ filename, content }]
+ */
+export declare function handlePushWireframes(client: VadenMcpApiClient, projectId: string, files: Array<{
+    filename: string;
+    content: string;
+}>): Promise<{
+    type: "text";
+    text: string;
+}[]>;
 /**
  * ワイヤーフレーム一覧を返す
  *

package/dist/tools/wireframes.js

@@ -168,7 +168,45 @@ function generateWireframeDetailGuide(screen) {
     }
     return lines.join("\n");
 }
-// --- ツールハンドラー ---
+/**
+ * ワイヤーフレームの特定フィールドを更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param fieldPath - ドット区切りのフィールドパス（例: 'screens.0.name'）
+ * @param value - 新しい値
+ */
+export async function handleUpdateWireframe(client, projectId, fieldPath, value, operation = "update") {
+    await client.patch(`/api/projects/${encodeURIComponent(projectId)}/wireframe`, { fieldPath, value, operation });
+    const actionLabel = operation === "add"
+        ? "added to"
+        : operation === "remove"
+            ? "removed from"
+            : "updated in";
+    return [
+        {
+            type: "text",
+            text: `Wireframe: element ${actionLabel} "${fieldPath}"${operation !== "remove" ? ` — ${JSON.stringify(value)}` : ""}`,
+        },
+    ];
+}
+/**
+ * UXIR ファイルを一括プッシュしてワイヤーフレームを更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param files - UXIR ファイル一覧 [{ filename, content }]
+ */
+export async function handlePushWireframes(client, projectId, files) {
+    const result = await client.post(`/api/projects/${encodeURIComponent(projectId)}/uxir`, { files });
+    return [
+        {
+            type: "text",
+            text: `Wireframes pushed successfully.\n- Files accepted: ${String(result.accepted)}\n- Screens: ${String(result.screens)}\n- Transitions: ${String(result.transitions)}`,
+        },
+    ];
+}
+// --- Read ハンドラー ---
 /**
  * ワイヤーフレーム一覧を返す
  *

package/dist/tools/write-components.d.ts

@@ -0,0 +1,18 @@
+/**
+ * コンポーネントスタイル更新 MCP ツールハンドラー
+ *
+ * PATCH /api/projects/{projectId}/design-system/component-styles/{component}
+ */
+import type { VadenMcpApiClient } from "../api-client.js";
+/**
+ * コンポーネントスタイルオーバーライドを更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param component - コンポーネント名（例: button, card）
+ * @param updatedStyleConfig - 更新するスタイル設定
+ */
+export declare function handleUpdateComponentStyle(client: VadenMcpApiClient, projectId: string, component: string, updatedStyleConfig: Record<string, unknown>): Promise<{
+    type: "text";
+    text: string;
+}[]>;

package/dist/tools/write-components.js

@@ -0,0 +1,17 @@
+/**
+ * コンポーネントスタイルオーバーライドを更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param component - コンポーネント名（例: button, card）
+ * @param updatedStyleConfig - 更新するスタイル設定
+ */
+export async function handleUpdateComponentStyle(client, projectId, component, updatedStyleConfig) {
+    const result = await client.patch(`/api/projects/${encodeURIComponent(projectId)}/design-system/component-styles/${encodeURIComponent(component)}`, { updatedStyleConfig });
+    return [
+        {
+            type: "text",
+            text: `Component style for "${result.component}" updated successfully. Override applied: ${String(result.overrideApplied)}`,
+        },
+    ];
+}

package/dist/tools/write-tokens.d.ts

@@ -0,0 +1,17 @@
+/**
+ * デザイントークン更新 MCP ツールハンドラー
+ *
+ * PATCH /api/projects/{projectId}/design-system/tokens
+ */
+import type { VadenMcpApiClient } from "../api-client.js";
+/**
+ * デザイントークンを部分更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param tokens - 更新するトークン（deep merge）
+ */
+export declare function handleUpdateDesignTokens(client: VadenMcpApiClient, projectId: string, tokens: Record<string, unknown>): Promise<{
+    type: "text";
+    text: string;
+}[]>;

package/dist/tools/write-tokens.js

@@ -0,0 +1,16 @@
+/**
+ * デザイントークンを部分更新する
+ *
+ * @param client - Vaden MCP API クライアント
+ * @param projectId - プロジェクトID
+ * @param tokens - 更新するトークン（deep merge）
+ */
+export async function handleUpdateDesignTokens(client, projectId, tokens) {
+    const result = await client.patch(`/api/projects/${encodeURIComponent(projectId)}/design-system/tokens`, { tokens });
+    return [
+        {
+            type: "text",
+            text: `Design tokens updated successfully.\n\n\`\`\`json\n${JSON.stringify(result.tokens, null, 2)}\n\`\`\``,
+        },
+    ];
+}

package/dist/validation.d.ts

@@ -0,0 +1,42 @@
+/**
+ * MCP ツール引数のバリデーションユーティリティ
+ */
+/**
+ * update_concept / update_wireframe 用のフィールド更新引数を検証・抽出する
+ *
+ * @returns { fieldPath, value } — 検証済みの値
+ * @throws {Error} 引数が不正な場合
+ */
+export declare function validateFieldUpdateArgs(args: Record<string, unknown>): {
+    fieldPath: string;
+    value: string | number | boolean | null;
+};
+/**
+ * add_wireframe_element / add_concept_element 用の引数を検証・抽出する
+ *
+ * @returns { fieldPath, value } — 検証済みの値
+ * @throws {Error} 引数が不正な場合
+ */
+export declare function validateArrayAddArgs(args: Record<string, unknown>): {
+    fieldPath: string;
+    value: unknown;
+};
+/**
+ * remove_wireframe_element / remove_concept_element 用の引数を検証・抽出する
+ *
+ * @returns { fieldPath } — 検証済みの値
+ * @throws {Error} 引数が不正な場合
+ */
+export declare function validateArrayRemoveArgs(args: Record<string, unknown>): {
+    fieldPath: string;
+};
+/**
+ * push_wireframes 用の files 引数を検証する
+ *
+ * @returns 検証済みの files 配列
+ * @throws {Error} 引数が不正な場合
+ */
+export declare function validatePushWireframesArgs(args: Record<string, unknown>): Array<{
+    filename: string;
+    content: string;
+}>;

package/dist/validation.js

@@ -0,0 +1,83 @@
+/**
+ * MCP ツール引数のバリデーションユーティリティ
+ */
+/**
+ * update_concept / update_wireframe 用のフィールド更新引数を検証・抽出する
+ *
+ * @returns { fieldPath, value } — 検証済みの値
+ * @throws {Error} 引数が不正な場合
+ */
+export function validateFieldUpdateArgs(args) {
+    const fieldPath = String(args.field_path ?? "");
+    if (!fieldPath) {
+        throw new Error("field_path パラメータが必要です");
+    }
+    const rawValue = args.value;
+    if (rawValue === undefined) {
+        throw new Error("value パラメータが必要です");
+    }
+    const valueType = typeof rawValue;
+    if (rawValue !== null &&
+        valueType !== "string" &&
+        valueType !== "number" &&
+        valueType !== "boolean") {
+        throw new Error("value パラメータは string, number, boolean, null のいずれかである必要があります");
+    }
+    return { fieldPath, value: rawValue };
+}
+/**
+ * add_wireframe_element / add_concept_element 用の引数を検証・抽出する
+ *
+ * @returns { fieldPath, value } — 検証済みの値
+ * @throws {Error} 引数が不正な場合
+ */
+export function validateArrayAddArgs(args) {
+    const fieldPath = String(args.field_path ?? "");
+    if (!fieldPath) {
+        throw new Error("field_path パラメータが必要です");
+    }
+    const value = args.value;
+    if (value === undefined) {
+        throw new Error("value パラメータが必要です");
+    }
+    return { fieldPath, value };
+}
+/**
+ * remove_wireframe_element / remove_concept_element 用の引数を検証・抽出する
+ *
+ * @returns { fieldPath } — 検証済みの値
+ * @throws {Error} 引数が不正な場合
+ */
+export function validateArrayRemoveArgs(args) {
+    const fieldPath = String(args.field_path ?? "");
+    if (!fieldPath) {
+        throw new Error("field_path パラメータが必要です");
+    }
+    // 最後のセグメントが数値であることを検証
+    const lastSegment = fieldPath.split(".").pop() ?? "";
+    if (!/^\d+$/.test(lastSegment)) {
+        throw new Error("field_path の最後のセグメントは数値インデックスである必要があります（例: screens.2, screens.0.components.3）");
+    }
+    return { fieldPath };
+}
+/**
+ * push_wireframes 用の files 引数を検証する
+ *
+ * @returns 検証済みの files 配列
+ * @throws {Error} 引数が不正な場合
+ */
+export function validatePushWireframesArgs(args) {
+    const files = args.files;
+    if (!Array.isArray(files) || files.length === 0) {
+        throw new Error("files パラメータが必要です（非空の配列）");
+    }
+    for (const file of files) {
+        if (typeof file !== "object" ||
+            file === null ||
+            typeof file.filename !== "string" ||
+            typeof file.content !== "string") {
+            throw new Error("files の各要素は { filename: string, content: string } である必要があります");
+        }
+    }
+    return files;
+}

package/package.json

@@ -10,7 +10,7 @@
   ],
   "homepage": "https://vaden.ai",
   "license": "MIT",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "publishConfig": {
     "access": "public"