@anri1214/dynamic-forms-mui-mcp 0.1.5

package/dist/schema/versions.json

@@ -0,0 +1,6 @@
+{
+  "latest": "0.1",
+  "available": [
+    "0.1"
+  ]
+}

package/dist/schemaLoader.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Central version-aware schema loader.
+ *
+ * All tools and resources use this module to load versioned schema data
+ * from `src/schema/{version}/` directories.
+ *
+ * Versions are stored as major.minor (e.g. "0.1", "0.2", "1.0").
+ * Patch versions are ignored — "0.1.0", "0.1.5", and "0.1" all resolve to "0.1".
+ */
+import type { FieldTypesData, VersionsManifest } from './types.js';
+/**
+ * Returns the versions manifest: latest version and list of all available versions.
+ */
+export declare function getAvailableVersions(): VersionsManifest;
+/**
+ * Normalizes and validates a version. Accepts both "0.1.0" and "0.1".
+ * Throws if the normalized version is not found.
+ */
+export declare function resolveVersion(version: string): string;
+/**
+ * Loads the FormSchema JSON Schema for a given library version.
+ */
+export declare function loadFormSchema(version: string): Record<string, unknown>;
+/**
+ * Loads field types data for a given library version.
+ */
+export declare function loadFieldTypes(version: string): FieldTypesData;
+/**
+ * Lists available example names for a given library version.
+ */
+export declare function loadExampleNames(version: string): string[];
+/**
+ * Loads a specific example by name for a given library version.
+ * Returns null if example not found.
+ */
+export declare function loadExample(version: string, name: string): unknown | null;
+//# sourceMappingURL=schemaLoader.d.ts.map

package/dist/schemaLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaLoader.d.ts","sourceRoot":"","sources":["../src/schemaLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAsBlE;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAEvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQtD;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAG9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAU1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAOzE"}

package/dist/schemaLoader.js

@@ -0,0 +1,89 @@
+/**
+ * Central version-aware schema loader.
+ *
+ * All tools and resources use this module to load versioned schema data
+ * from `src/schema/{version}/` directories.
+ *
+ * Versions are stored as major.minor (e.g. "0.1", "0.2", "1.0").
+ * Patch versions are ignored — "0.1.0", "0.1.5", and "0.1" all resolve to "0.1".
+ */
+import { createRequire } from 'node:module';
+import { readdirSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const require = createRequire(import.meta.url);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const versionsManifest = require('./schema/versions.json');
+// ── Version helpers ────────────────────────────────────────
+/**
+ * Normalizes a version string to major.minor format.
+ * "0.1.0" → "0.1", "0.1" → "0.1", "1.2.3" → "1.2"
+ */
+function normalizeVersion(version) {
+    const parts = version.split('.');
+    if (parts.length < 2) {
+        return version; // let resolveVersion handle the error
+    }
+    return `${parts[0]}.${parts[1]}`;
+}
+/**
+ * Returns the versions manifest: latest version and list of all available versions.
+ */
+export function getAvailableVersions() {
+    return { ...versionsManifest };
+}
+/**
+ * Normalizes and validates a version. Accepts both "0.1.0" and "0.1".
+ * Throws if the normalized version is not found.
+ */
+export function resolveVersion(version) {
+    const normalized = normalizeVersion(version);
+    if (!versionsManifest.available.includes(normalized)) {
+        throw new Error(`Unknown version "${version}" (normalized: "${normalized}"). Available versions: ${versionsManifest.available.join(', ')}`);
+    }
+    return normalized;
+}
+// ── Schema loaders ─────────────────────────────────────────
+/**
+ * Loads the FormSchema JSON Schema for a given library version.
+ */
+export function loadFormSchema(version) {
+    const v = resolveVersion(version);
+    return require(`./schema/${v}/formSchema.json`);
+}
+/**
+ * Loads field types data for a given library version.
+ */
+export function loadFieldTypes(version) {
+    const v = resolveVersion(version);
+    return require(`./schema/${v}/fieldTypes.json`);
+}
+/**
+ * Lists available example names for a given library version.
+ */
+export function loadExampleNames(version) {
+    const v = resolveVersion(version);
+    const examplesDir = resolve(__dirname, 'schema', v, 'examples');
+    try {
+        return readdirSync(examplesDir)
+            .filter((f) => f.endsWith('.json'))
+            .map((f) => f.replace('.json', ''));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Loads a specific example by name for a given library version.
+ * Returns null if example not found.
+ */
+export function loadExample(version, name) {
+    const v = resolveVersion(version);
+    try {
+        return require(`./schema/${v}/examples/${name}.json`);
+    }
+    catch {
+        return null;
+    }
+}

package/dist/tools/generateSchema.d.ts

@@ -0,0 +1,30 @@
+interface FieldHint {
+    name: string;
+    type: string;
+    label?: string;
+    required?: boolean;
+    extraProps?: Record<string, unknown>;
+    validationRules?: Record<string, unknown>;
+}
+interface GenerateInput {
+    version: string;
+    description?: string;
+    fields: FieldHint[];
+    sections?: Array<{
+        id: string;
+        title: string;
+        fieldNames: string[];
+    }>;
+}
+/**
+ * Generates a FormSchema JSON from a high-level description of fields.
+ * If no sections are provided, all fields are placed in a single "main" section.
+ * The result is validated against the schema for the specified library version.
+ */
+export declare function generateFormSchema(input: GenerateInput): {
+    schema: unknown;
+    valid: boolean;
+    errors: string[];
+};
+export {};
+//# sourceMappingURL=generateSchema.d.ts.map

package/dist/tools/generateSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateSchema.d.ts","sourceRoot":"","sources":["../../src/tools/generateSchema.ts"],"names":[],"mappings":"AAEA,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,EAAE,CAAA;KACrB,CAAC,CAAA;CACH;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG;IACxD,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CA2DA"}

package/dist/tools/generateSchema.js

@@ -0,0 +1,58 @@
+import { validateFormSchema } from './validateSchema.js';
+/**
+ * Generates a FormSchema JSON from a high-level description of fields.
+ * If no sections are provided, all fields are placed in a single "main" section.
+ * The result is validated against the schema for the specified library version.
+ */
+export function generateFormSchema(input) {
+    const fields = {};
+    for (const hint of input.fields) {
+        const field = {
+            type: hint.type,
+            label: hint.label ?? hint.name,
+        };
+        // Apply extra props
+        if (hint.extraProps) {
+            Object.assign(field, hint.extraProps);
+        }
+        // Build validation
+        const validation = {};
+        if (hint.required) {
+            validation.required = true;
+        }
+        if (hint.validationRules) {
+            Object.assign(validation, hint.validationRules);
+        }
+        if (Object.keys(validation).length > 0) {
+            field.validation = validation;
+        }
+        fields[hint.name] = field;
+    }
+    // Build sections
+    let sections;
+    if (input.sections && input.sections.length > 0) {
+        sections = input.sections.map((s) => ({
+            id: s.id,
+            title: s.title,
+            fields: s.fieldNames,
+        }));
+    }
+    else {
+        // Single auto-section with all fields
+        sections = [
+            {
+                id: 'main',
+                title: input.description ?? 'Form',
+                fields: input.fields.map((f) => f.name),
+            },
+        ];
+    }
+    const schema = { sections, fields };
+    // Validate the generated schema against the specified version
+    const result = validateFormSchema(input.version, schema);
+    return {
+        schema,
+        valid: result.valid,
+        errors: result.errors,
+    };
+}

package/dist/tools/getFieldConfig.d.ts

@@ -0,0 +1,18 @@
+interface FieldTypeDetail {
+    type: string;
+    description: string;
+    config: string;
+    specificProps: string[];
+    applicableValidations: string[];
+    example: unknown;
+}
+/**
+ * Returns detailed information about a specific field type for a given library version.
+ */
+export declare function getFieldConfig(version: string, fieldType: string): FieldTypeDetail | null;
+/**
+ * Returns all known field type names for a given library version.
+ */
+export declare function getKnownFieldTypes(version: string): string[];
+export {};
+//# sourceMappingURL=getFieldConfig.d.ts.map

package/dist/tools/getFieldConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFieldConfig.d.ts","sourceRoot":"","sources":["../../src/tools/getFieldConfig.ts"],"names":[],"mappings":"AAGA,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAazF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAG5D"}

package/dist/tools/getFieldConfig.js

@@ -0,0 +1,25 @@
+import { loadFieldTypes } from '../schemaLoader.js';
+/**
+ * Returns detailed information about a specific field type for a given library version.
+ */
+export function getFieldConfig(version, fieldType) {
+    const fieldTypesData = loadFieldTypes(version);
+    const ft = fieldTypesData.fieldTypes.find((f) => f.type === fieldType);
+    if (!ft)
+        return null;
+    return {
+        type: ft.type,
+        description: ft.description,
+        config: ft.config,
+        specificProps: ft.specificProps,
+        applicableValidations: ft.applicableValidations,
+        example: ft.example,
+    };
+}
+/**
+ * Returns all known field type names for a given library version.
+ */
+export function getKnownFieldTypes(version) {
+    const fieldTypesData = loadFieldTypes(version);
+    return fieldTypesData.fieldTypes.map((ft) => ft.type);
+}

package/dist/tools/listFieldTypes.d.ts

@@ -0,0 +1,13 @@
+interface FieldTypeSummary {
+    type: string;
+    description: string;
+    config: string;
+    specificProps: string[];
+    applicableValidations: string[];
+}
+/**
+ * Returns a summary of all supported field types for a given library version.
+ */
+export declare function listFieldTypes(version: string): FieldTypeSummary[];
+export {};
+//# sourceMappingURL=listFieldTypes.d.ts.map

package/dist/tools/listFieldTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listFieldTypes.d.ts","sourceRoot":"","sources":["../../src/tools/listFieldTypes.ts"],"names":[],"mappings":"AAEA,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,qBAAqB,EAAE,MAAM,EAAE,CAAA;CAChC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CASlE"}

package/dist/tools/listFieldTypes.js

@@ -0,0 +1,14 @@
+import { loadFieldTypes } from '../schemaLoader.js';
+/**
+ * Returns a summary of all supported field types for a given library version.
+ */
+export function listFieldTypes(version) {
+    const fieldTypesData = loadFieldTypes(version);
+    return fieldTypesData.fieldTypes.map((ft) => ({
+        type: ft.type,
+        description: ft.description,
+        config: ft.config,
+        specificProps: ft.specificProps,
+        applicableValidations: ft.applicableValidations,
+    }));
+}

package/dist/tools/validateSchema.d.ts

@@ -0,0 +1,10 @@
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validates a JSON object against the FormSchema JSON Schema for a given library version.
+ * Returns structured errors pointing to exact paths.
+ */
+export declare function validateFormSchema(version: string, schema: unknown): ValidationResult;
+//# sourceMappingURL=validateSchema.d.ts.map

package/dist/tools/validateSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSchema.d.ts","sourceRoot":"","sources":["../../src/tools/validateSchema.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAgBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAgBrF"}

package/dist/tools/validateSchema.js

@@ -0,0 +1,32 @@
+import Ajv from 'ajv';
+import { loadFormSchema } from '../schemaLoader.js';
+// Cache compiled validators per version to avoid recompilation
+const validatorCache = new Map();
+function getValidator(version) {
+    const cached = validatorCache.get(version);
+    if (cached)
+        return cached;
+    const formSchema = loadFormSchema(version);
+    const ajv = new Ajv.default({ allErrors: true, verbose: true });
+    const validate = ajv.compile(formSchema);
+    validatorCache.set(version, validate);
+    return validate;
+}
+/**
+ * Validates a JSON object against the FormSchema JSON Schema for a given library version.
+ * Returns structured errors pointing to exact paths.
+ */
+export function validateFormSchema(version, schema) {
+    const validate = getValidator(version);
+    const valid = validate(schema);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors ?? []).map((err) => {
+        const path = err.instancePath || '/';
+        const message = err.message ?? 'unknown error';
+        const params = err.params ? ` (${JSON.stringify(err.params)})` : '';
+        return `${path}: ${message}${params}`;
+    });
+    return { valid: false, errors };
+}

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+/** Shape of a single entry in fieldTypes.json */
+export interface FieldTypeEntry {
+    type: string;
+    description: string;
+    config: string;
+    specificProps: string[];
+    applicableValidations: string[];
+    example: Record<string, unknown>;
+}
+/** Shape of fieldTypes.json */
+export interface FieldTypesData {
+    fieldTypes: FieldTypeEntry[];
+}
+/** Shape of versions.json */
+export interface VersionsManifest {
+    latest: string;
+    available: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,cAAc,EAAE,CAAA;CAC7B;AAED,6BAA6B;AAC7B,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@anri1214/dynamic-forms-mui-mcp",
+  "version": "0.1.5",
+  "description": "MCP server for dynamic-forms-mui — exposes FormSchema structure as tools, resources, and prompts for AI assistants",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "dynamic-forms-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "dynamic-forms",
+    "form-schema",
+    "ai",
+    "cursor",
+    "claude",
+    "mui",
+    "react"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "ajv": "^8.17.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "~5.7.3",
+    "tsx": "^4.19.0"
+  },
+  "scripts": {
+    "build:schema": "tsx scripts/generateJsonSchema.ts",
+    "build": "npm run build:schema && tsc && cp -r src/schema dist/schema",
+    "bump:patch": "npm version patch",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}