@docxkit/mcp 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,1301 @@
+import { AiTemplateInfo } from "@docxkit/ai";
+import { DocxPlugin, DocxSchema } from "@docxkit/core";
+
+//#region src/resources/schema.d.ts
+/**
+ * MCP resource: DocxSchema JSON Schema.
+ *
+ * Provides a complete JSON Schema for the DocxSchema type,
+ * enabling LLMs to understand the expected document structure.
+ *
+ * @module mcp-server/resources/schema
+ */
+/**
+ * DocxSchema JSON Schema for MCP resource exposure.
+ *
+ * This schema describes the expected structure of a
+ * docx-kit document schema, suitable for LLM reference.
+ */
+declare const docxSchemaResource: {
+  mimeType: string;
+  name: string;
+  description: string;
+  schema: {
+    $id: string;
+    $schema: string;
+    description: string;
+    required: string[];
+    title: string;
+    type: string;
+    definitions: {
+      blockNode: {
+        oneOf: ({
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            type: {
+              const: string;
+            };
+            items: {
+              items: {
+                type: string;
+              };
+              type: string;
+            };
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            className: {
+              type: string;
+            };
+            level: {
+              enum: number[];
+              type: string;
+            };
+            style: {
+              additionalProperties: boolean;
+              type: string;
+            };
+            text: {
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            items?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            type: {
+              const: string;
+            };
+            url: {
+              type: string;
+            };
+            children: {
+              items: {
+                type: string;
+                additionalProperties?: undefined;
+              };
+              type: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            alt: {
+              type: string;
+            };
+            data: {
+              type: string;
+              items?: undefined;
+            };
+            height: {
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            width: {
+              type: string;
+            };
+            imageType: {
+              enum: string[];
+              type: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          properties: {
+            type: {
+              const: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+          required: string[];
+          type: string;
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            className: {
+              type: string;
+            };
+            style: {
+              additionalProperties: boolean;
+              type: string;
+            };
+            text: {
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            children: {
+              items: {
+                additionalProperties: boolean;
+                type: string;
+              };
+              type: string;
+            };
+            items?: undefined;
+            level?: undefined;
+            url?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            name: {
+              type: string;
+            };
+            options: {
+              additionalProperties: boolean;
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            config: {
+              additionalProperties: boolean;
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            header: {
+              type: string;
+            };
+            striped: {
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            columns: {
+              type: string;
+              items: {
+                required: string[];
+                type: string;
+                properties: {
+                  key: {
+                    type: string;
+                  };
+                  title: {
+                    type: string;
+                  };
+                  width: {
+                    type: string;
+                  };
+                  align: {
+                    enum: string[];
+                    type: string;
+                  };
+                };
+              };
+            };
+            data: {
+              items: {
+                additionalProperties: boolean;
+                type: string;
+              };
+              type: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+          };
+        })[];
+      };
+      styleRule: {
+        additionalProperties: boolean;
+        description: string;
+        type: string;
+        properties: {
+          backgroundColor: {
+            type: string;
+          };
+          borderBottom: {
+            type: string;
+          };
+          borderLeft: {
+            type: string;
+          };
+          borderRight: {
+            type: string;
+          };
+          borderTop: {
+            type: string;
+          };
+          color: {
+            type: string;
+          };
+          fontFamily: {
+            type: string;
+          };
+          fontSize: {
+            type: string;
+          };
+          fontWeight: {
+            enum: string[];
+            type: string;
+          };
+          lineHeight: {
+            type: string;
+          };
+          marginBottom: {
+            type: string;
+          };
+          marginLeft: {
+            type: string;
+          };
+          marginTop: {
+            type: string;
+          };
+          textAlign: {
+            enum: string[];
+            type: string;
+          };
+        };
+      };
+    };
+    properties: {
+      content: {
+        description: string;
+        items: {
+          $ref: string;
+        };
+        type: string;
+      };
+      page: {
+        description: string;
+        type: string;
+        properties: {
+          margin: {
+            type: string;
+          };
+          orientation: {
+            enum: string[];
+            type: string;
+          };
+          size: {
+            enum: string[];
+            type: string;
+          };
+        };
+      };
+      plugins: {
+        description: string;
+        type: string;
+        items: {
+          required: string[];
+          type: string;
+          properties: {
+            plugin: {
+              description: string;
+              type: string;
+            };
+            type: {
+              enum: string[];
+              type: string;
+            };
+          };
+        };
+      };
+      styles: {
+        additionalProperties: {
+          $ref: string;
+        };
+        description: string;
+        type: string;
+      };
+    };
+  };
+};
+//#endregion
+//#region src/tools/createDocx.d.ts
+/**
+ * Input schema for the create_document MCP tool.
+ */
+interface CreateDocumentInput {
+  /** File path for the output .docx file. */
+  outputPath: string;
+  /** The docx-kit DocxSchema defining the document. */
+  schema: DocxSchema;
+}
+/**
+ * Output from the create_document MCP tool.
+ */
+interface CreateDocumentOutput {
+  /** Path of the created file. */
+  filePath: string;
+  /** File size in bytes. */
+  size: number;
+}
+/**
+ * MCP tool definition for `create_document`.
+ *
+ * Creates a new .docx file from a docx-kit JSON schema.
+ * Takes an `outputPath` and a `schema` (DocxSchema JSON object).
+ *
+ * @remarks Used by the MCP server as a tool registration.
+ */
+declare const createDocxToolDefinition: {
+  name: string;
+  description: string;
+  inputSchema: {
+    required: string[];
+    type: string;
+    properties: {
+      outputPath: {
+        description: string;
+        type: string;
+      };
+      schema: {
+        type: string;
+        description: string;
+      };
+    };
+  };
+};
+//#endregion
+//#region src/tools/applyTemplate.d.ts
+/**
+ * Input for the apply_template MCP tool.
+ */
+interface ApplyTemplateInput {
+  /** Template parameter values (match template schema). */
+  data: Record<string, unknown>;
+  /** Name of the template to apply. */
+  template: string;
+}
+/**
+ * Output from the apply_template MCP tool.
+ */
+interface ApplyTemplateOutput {
+  /** The generated DocxSchema. */
+  schema: DocxSchema;
+  /** Name of the template used. */
+  templateName: string;
+}
+/**
+ * MCP tool definition for `apply_template`.
+ *
+ * Generates a DocxSchema from a named template + data params.
+ */
+declare const applyTemplateToolDefinition: {
+  name: string;
+  description: string;
+  inputSchema: {
+    required: string[];
+    type: string;
+    properties: {
+      data: {
+        description: string;
+        type: string;
+      };
+      template: {
+        type: string;
+        description: string;
+      };
+    };
+  };
+};
+/**
+ * Apply a template with given data to produce a DocxSchema.
+ *
+ * @param templateName - — Template name (e.g. 'report')
+ * @param data - — Template parameters
+ * @returns Generated DocxSchema and template name, or null if template not found
+ */
+declare function applyTemplate(templateName: string, data: Record<string, unknown>): ApplyTemplateOutput | null;
+//#endregion
+//#region src/tools/getPluginHelp.d.ts
+/**
+ * Plugin help info returned by get_plugin_help.
+ */
+interface PluginHelpInfo {
+  /** Detailed description of the plugin. */
+  description: string;
+  /** Plugin name. */
+  name: string;
+  /** Example usage in JSON DSL. */
+  usageExample: string;
+}
+/**
+ * MCP tool definition for `get_plugin_help`.
+ *
+ * Returns usage help and option schema for a named plugin.
+ */
+declare const getPluginHelpToolDefinition: {
+  name: string;
+  description: string;
+  inputSchema: {
+    required: string[];
+    type: string;
+    properties: {
+      pluginName: {
+        description: string;
+        type: string;
+      };
+    };
+  };
+};
+/**
+ * Build help info for a plugin.
+ *
+ * Provides a usage example based on the plugin name,
+ * referencing a built-in map of known plugins.
+ *
+ * @param plugin - — The DocxPlugin to build help for
+ * @returns PluginHelpInfo with description, name, and usage example
+ */
+declare function buildPluginHelp(plugin: DocxPlugin): PluginHelpInfo;
+//#endregion
+//#region src/tools/listPlugins.d.ts
+/**
+ * Plugin info returned by the list_plugins tool.
+ */
+interface PluginInfo {
+  /** Plugin description (derived from name and render signature). */
+  description: string;
+  /** Plugin name. */
+  name: string;
+}
+/**
+ * MCP tool definition for `list_plugins`.
+ *
+ * Returns metadata for all registered plugins.
+ */
+declare const listPluginsToolDefinition: {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: string;
+    properties: {
+      filter: {
+        description: string;
+        type: string;
+      };
+    };
+  };
+};
+/**
+ * Build plugin info from a list of DocxPlugin instances.
+ *
+ * Optionally filters by a case-insensitive name substring.
+ *
+ * @param plugins - — Registered plugins
+ * @param filter - — Optional name filter pattern (case-insensitive)
+ * @returns Array of PluginInfo objects
+ */
+declare function buildPluginInfoList(plugins: DocxPlugin[], filter?: string): PluginInfo[];
+//#endregion
+//#region src/tools/validateSchema.d.ts
+/**
+ * MCP tool: validate a docx-kit JSON schema.
+ *
+ * @module mcp-server/tools/validateSchema
+ */
+/**
+ * Output from the validate_schema MCP tool.
+ */
+interface ValidateSchemaOutput {
+  /** List of validation errors (empty if valid). */
+  errors: ValidationError[];
+  /** Whether the schema is valid. */
+  valid: boolean;
+}
+/**
+ * Validation error detail.
+ */
+interface ValidationError {
+  /** Error description. */
+  message: string;
+  /** JSON path to the invalid field. */
+  path: string;
+}
+/**
+ * MCP tool definition for `validate_schema`.
+ *
+ * Validates a docx-kit JSON schema and returns
+ * detailed error information.
+ */
+declare const validateSchemaToolDefinition: {
+  name: string;
+  description: string;
+  inputSchema: {
+    required: string[];
+    type: string;
+    properties: {
+      schema: {
+        description: string;
+        type: string;
+      };
+    };
+  };
+};
+/**
+ * Validate a DocxSchema object.
+ *
+ * Checks for:
+ * - Required `content` array
+ * - Valid node types in content
+ * - Required fields per node type
+ *
+ * @param schema - — The schema to validate
+ * @returns Validation result with errors
+ */
+declare function validateSchema(schema: unknown): ValidateSchemaOutput;
+//#endregion
+//#region src/tools/listTemplates.d.ts
+/**
+ * MCP tool definition for `list_templates`.
+ *
+ * Returns all available docx-kit AI templates.
+ */
+declare const listTemplatesToolDefinition: {
+  name: string;
+  description: string;
+  inputSchema: {
+    properties: {};
+    type: string;
+  };
+};
+/**
+ * Build template info list from built-in templates.
+ *
+ * @returns Array of template info (without generator)
+ */
+declare function buildTemplateInfoList(): AiTemplateInfo[];
+//#endregion
+//#region src/index.d.ts
+/**
+ * docx-kit MCP server — AI agent integration via
+ * Model Context Protocol.
+ *
+ * Provides tools for document creation, validation,
+ * plugin discovery, template application, and schema resources.
+ *
+ * The server uses `@modelcontextprotocol/sdk` (optional peer dep)
+ * for MCP protocol handling. If the SDK is not installed,
+ * individual tool/resource definitions and execution logic
+ * can still be used programmatically.
+ *
+ * @module mcp-server
+ */
+/**
+ * All MCP tool definitions for docx-kit.
+ */
+declare const TOOL_DEFINITIONS: readonly [{
+  name: string;
+  description: string;
+  inputSchema: {
+    required: string[];
+    type: string;
+    properties: {
+      data: {
+        description: string;
+        type: string;
+      };
+      template: {
+        type: string;
+        description: string;
+      };
+    };
+  };
+}, {
+  name: string;
+  description: string;
+  inputSchema: {
+    required: string[];
+    type: string;
+    properties: {
+      outputPath: {
+        description: string;
+        type: string;
+      };
+      schema: {
+        type: string;
+        description: string;
+      };
+    };
+  };
+}, {
+  name: string;
+  description: string;
+  inputSchema: {
+    required: string[];
+    type: string;
+    properties: {
+      pluginName: {
+        description: string;
+        type: string;
+      };
+    };
+  };
+}, {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: string;
+    properties: {
+      filter: {
+        description: string;
+        type: string;
+      };
+    };
+  };
+}, {
+  name: string;
+  description: string;
+  inputSchema: {
+    properties: {};
+    type: string;
+  };
+}, {
+  name: string;
+  description: string;
+  inputSchema: {
+    required: string[];
+    type: string;
+    properties: {
+      schema: {
+        description: string;
+        type: string;
+      };
+    };
+  };
+}];
+/**
+ * All MCP resource definitions for docx-kit.
+ */
+declare const RESOURCE_DEFINITIONS: readonly [{
+  mimeType: string;
+  name: string;
+  description: string;
+  schema: {
+    $id: string;
+    $schema: string;
+    description: string;
+    required: string[];
+    title: string;
+    type: string;
+    definitions: {
+      blockNode: {
+        oneOf: ({
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            type: {
+              const: string;
+            };
+            items: {
+              items: {
+                type: string;
+              };
+              type: string;
+            };
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            className: {
+              type: string;
+            };
+            level: {
+              enum: number[];
+              type: string;
+            };
+            style: {
+              additionalProperties: boolean;
+              type: string;
+            };
+            text: {
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            items?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            type: {
+              const: string;
+            };
+            url: {
+              type: string;
+            };
+            children: {
+              items: {
+                type: string;
+                additionalProperties?: undefined;
+              };
+              type: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            alt: {
+              type: string;
+            };
+            data: {
+              type: string;
+              items?: undefined;
+            };
+            height: {
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            width: {
+              type: string;
+            };
+            imageType: {
+              enum: string[];
+              type: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          properties: {
+            type: {
+              const: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+          required: string[];
+          type: string;
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            className: {
+              type: string;
+            };
+            style: {
+              additionalProperties: boolean;
+              type: string;
+            };
+            text: {
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            children: {
+              items: {
+                additionalProperties: boolean;
+                type: string;
+              };
+              type: string;
+            };
+            items?: undefined;
+            level?: undefined;
+            url?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            name: {
+              type: string;
+            };
+            options: {
+              additionalProperties: boolean;
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            config?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            config: {
+              additionalProperties: boolean;
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            data?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            header?: undefined;
+            striped?: undefined;
+            columns?: undefined;
+          };
+        } | {
+          description: string;
+          required: string[];
+          type: string;
+          properties: {
+            header: {
+              type: string;
+            };
+            striped: {
+              type: string;
+            };
+            type: {
+              const: string;
+            };
+            columns: {
+              type: string;
+              items: {
+                required: string[];
+                type: string;
+                properties: {
+                  key: {
+                    type: string;
+                  };
+                  title: {
+                    type: string;
+                  };
+                  width: {
+                    type: string;
+                  };
+                  align: {
+                    enum: string[];
+                    type: string;
+                  };
+                };
+              };
+            };
+            data: {
+              items: {
+                additionalProperties: boolean;
+                type: string;
+              };
+              type: string;
+            };
+            items?: undefined;
+            className?: undefined;
+            level?: undefined;
+            style?: undefined;
+            text?: undefined;
+            url?: undefined;
+            children?: undefined;
+            alt?: undefined;
+            height?: undefined;
+            width?: undefined;
+            imageType?: undefined;
+            name?: undefined;
+            options?: undefined;
+            config?: undefined;
+          };
+        })[];
+      };
+      styleRule: {
+        additionalProperties: boolean;
+        description: string;
+        type: string;
+        properties: {
+          backgroundColor: {
+            type: string;
+          };
+          borderBottom: {
+            type: string;
+          };
+          borderLeft: {
+            type: string;
+          };
+          borderRight: {
+            type: string;
+          };
+          borderTop: {
+            type: string;
+          };
+          color: {
+            type: string;
+          };
+          fontFamily: {
+            type: string;
+          };
+          fontSize: {
+            type: string;
+          };
+          fontWeight: {
+            enum: string[];
+            type: string;
+          };
+          lineHeight: {
+            type: string;
+          };
+          marginBottom: {
+            type: string;
+          };
+          marginLeft: {
+            type: string;
+          };
+          marginTop: {
+            type: string;
+          };
+          textAlign: {
+            enum: string[];
+            type: string;
+          };
+        };
+      };
+    };
+    properties: {
+      content: {
+        description: string;
+        items: {
+          $ref: string;
+        };
+        type: string;
+      };
+      page: {
+        description: string;
+        type: string;
+        properties: {
+          margin: {
+            type: string;
+          };
+          orientation: {
+            enum: string[];
+            type: string;
+          };
+          size: {
+            enum: string[];
+            type: string;
+          };
+        };
+      };
+      plugins: {
+        description: string;
+        type: string;
+        items: {
+          required: string[];
+          type: string;
+          properties: {
+            plugin: {
+              description: string;
+              type: string;
+            };
+            type: {
+              enum: string[];
+              type: string;
+            };
+          };
+        };
+      };
+      styles: {
+        additionalProperties: {
+          $ref: string;
+        };
+        description: string;
+        type: string;
+      };
+    };
+  };
+}];
+/**
+ * Create a docx-kit MCP server.
+ *
+ * Uses `@modelcontextprotocol/sdk` to create a fully compliant
+ * MCP server with all docx-kit tools and resources registered.
+ *
+ * Requires `@modelcontextprotocol/sdk` to be installed.
+ * Connect via `StdioServerTransport` for CLI usage or
+ * `StreamableHTTPServerTransport` for HTTP access.
+ *
+ * @returns An MCP server instance ready to connect
+ *
+ * @example
+ * ```ts
+ * import { createDocxKitServer } from 'docx-kit/mcp'
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+ *
+ * const server = createDocxKitServer()
+ * const transport = new StdioServerTransport()
+ * await server.connect(transport)
+ * ```
+ */
+declare function createDocxKitServer(): Promise<unknown>;
+//#endregion
+export { type ApplyTemplateInput, type ApplyTemplateOutput, type CreateDocumentInput, type CreateDocumentOutput, type PluginHelpInfo, type PluginInfo, RESOURCE_DEFINITIONS, TOOL_DEFINITIONS, type ValidateSchemaOutput, type ValidationError, applyTemplate, applyTemplateToolDefinition, buildPluginHelp, buildPluginInfoList, buildTemplateInfoList, createDocxKitServer, createDocxToolDefinition, docxSchemaResource, getPluginHelpToolDefinition, listPluginsToolDefinition, listTemplatesToolDefinition, validateSchema, validateSchemaToolDefinition };