multisite-cms-mcp 1.0.0

package/dist/tools/validate-template.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTemplate = validateTemplate;
+const BLOG_FIELDS = [
+    { name: 'name', isRichText: false, isRequired: true },
+    { name: 'slug', isRichText: false, isRequired: true },
+    { name: 'mainImage', isRichText: false },
+    { name: 'thumbnailImage', isRichText: false },
+    { name: 'postSummary', isRichText: false },
+    { name: 'postBody', isRichText: true },
+    { name: 'featured', isRichText: false },
+    { name: 'publishedAt', isRichText: false },
+    { name: 'url', isRichText: false },
+];
+const AUTHOR_FIELDS = [
+    { name: 'name', isRichText: false, isRequired: true },
+    { name: 'slug', isRichText: false, isRequired: true },
+    { name: 'bio', isRichText: true },
+    { name: 'picture', isRichText: false },
+    { name: 'email', isRichText: false },
+    { name: 'twitterProfileLink', isRichText: false },
+    { name: 'linkedinProfileLink', isRichText: false },
+    { name: 'url', isRichText: false },
+];
+const TEAM_FIELDS = [
+    { name: 'name', isRichText: false, isRequired: true },
+    { name: 'slug', isRichText: false },
+    { name: 'role', isRichText: false },
+    { name: 'bio', isRichText: true },
+    { name: 'photo', isRichText: false },
+    { name: 'email', isRichText: false },
+    { name: 'order', isRichText: false },
+];
+const DOWNLOAD_FIELDS = [
+    { name: 'title', isRichText: false, isRequired: true },
+    { name: 'slug', isRichText: false },
+    { name: 'description', isRichText: false },
+    { name: 'fileUrl', isRichText: false },
+    { name: 'category', isRichText: false },
+    { name: 'order', isRichText: false },
+];
+// Common wrong field names and their corrections
+const COMMON_MISTAKES = {
+    'title': 'name (for blog posts) or title (for downloads)',
+    'body': 'postBody',
+    'content': 'postBody',
+    'excerpt': 'postSummary',
+    'summary': 'postSummary',
+    'image': 'mainImage or thumbnailImage',
+    'coverImage': 'mainImage',
+    'coverImageUrl': 'mainImage',
+    'heroImage': 'mainImage',
+    'thumbnail': 'thumbnailImage',
+    'date': 'publishedAt',
+    'createdAt': 'publishedAt',
+    'author_name': 'author.name',
+    'authorName': 'author.name',
+    'link': 'url',
+    'href': 'url',
+    'headshot': 'photo (for team) or picture (for authors)',
+    'headshotUrl': 'photo (for team) or picture (for authors)',
+    'position': 'role',
+    'jobTitle': 'role',
+};
+/**
+ * Validates an HTML template for correct CMS token usage
+ */
+async function validateTemplate(html, templateType, collectionSlug) {
+    const errors = [];
+    const warnings = [];
+    const suggestions = [];
+    // Get expected fields based on template type
+    let expectedFields = [];
+    let collectionName = '';
+    switch (templateType) {
+        case 'blog_index':
+        case 'blog_post':
+            expectedFields = BLOG_FIELDS;
+            collectionName = 'blogs';
+            break;
+        case 'authors_index':
+        case 'author_detail':
+            expectedFields = AUTHOR_FIELDS;
+            collectionName = 'authors';
+            break;
+        case 'team':
+            expectedFields = TEAM_FIELDS;
+            collectionName = 'team';
+            break;
+        case 'downloads':
+            expectedFields = DOWNLOAD_FIELDS;
+            collectionName = 'downloads';
+            break;
+        case 'custom_index':
+        case 'custom_detail':
+            collectionName = collectionSlug || 'collection';
+            break;
+        case 'static_page':
+            // Static pages just use data-edit-key
+            break;
+    }
+    // Extract all tokens from the HTML
+    const doubleTokens = html.match(/\{\{([^{}#/]+)\}\}/g) || [];
+    const tripleTokens = html.match(/\{\{\{([^{}]+)\}\}\}/g) || [];
+    const eachLoops = html.match(/\{\{#each\s+(\w+)[^}]*\}\}/g) || [];
+    const conditionals = html.match(/\{\{#if\s+([^}]+)\}\}/g) || [];
+    // Check for common mistakes
+    for (const token of doubleTokens) {
+        const fieldName = token.replace(/\{\{|\}\}/g, '').trim();
+        // Skip control structures
+        if (fieldName.startsWith('#') || fieldName.startsWith('/') || fieldName === 'else' || fieldName.startsWith('@')) {
+            continue;
+        }
+        // Check against common mistakes
+        const baseName = fieldName.split('.')[0];
+        if (COMMON_MISTAKES[baseName]) {
+            errors.push(`- Wrong token: {{${fieldName}}} → Use ${COMMON_MISTAKES[baseName]}`);
+        }
+    }
+    // Check richText fields are using triple braces
+    for (const field of expectedFields) {
+        if (field.isRichText) {
+            const doublePattern = new RegExp(`\\{\\{${field.name}\\}\\}`, 'g');
+            const triplePattern = new RegExp(`\\{\\{\\{${field.name}\\}\\}\\}`, 'g');
+            const hasDouble = doublePattern.test(html);
+            const hasTriple = triplePattern.test(html);
+            if (hasDouble && !hasTriple) {
+                errors.push(`- {{${field.name}}} must use triple braces {{{${field.name}}}} because it contains HTML`);
+            }
+        }
+    }
+    // Check for nested author fields in double braces (should be fine)
+    const authorBioDouble = /\{\{author\.bio\}\}/g.test(html);
+    if (authorBioDouble) {
+        errors.push('- {{author.bio}} must use triple braces {{{author.bio}}} because it contains HTML');
+    }
+    // Check loop syntax for index templates
+    if (templateType.endsWith('_index') || templateType === 'team' || templateType === 'downloads') {
+        if (eachLoops.length === 0) {
+            warnings.push(`- No {{#each}} loop found - index templates usually need a loop to display items`);
+        }
+        else {
+            // Check if loop uses correct collection name
+            for (const loop of eachLoops) {
+                const match = loop.match(/\{\{#each\s+(\w+)/);
+                if (match) {
+                    const usedCollection = match[1];
+                    if (collectionName && usedCollection !== collectionName) {
+                        warnings.push(`- Loop uses '${usedCollection}' but expected '${collectionName}'`);
+                    }
+                }
+            }
+        }
+    }
+    // Check for {{#each}} without closing {{/each}}
+    const eachOpens = (html.match(/\{\{#each/g) || []).length;
+    const eachCloses = (html.match(/\{\{\/each\}\}/g) || []).length;
+    if (eachOpens !== eachCloses) {
+        errors.push(`- Unbalanced {{#each}} loops: ${eachOpens} opens, ${eachCloses} closes`);
+    }
+    // Check for {{#if}} without closing {{/if}}
+    const ifOpens = (html.match(/\{\{#if/g) || []).length;
+    const ifCloses = (html.match(/\{\{\/if\}\}/g) || []).length;
+    if (ifOpens !== ifCloses) {
+        errors.push(`- Unbalanced {{#if}} conditionals: ${ifOpens} opens, ${ifCloses} closes`);
+    }
+    // Check for {{#unless}} without closing
+    const unlessOpens = (html.match(/\{\{#unless/g) || []).length;
+    const unlessCloses = (html.match(/\{\{\/unless\}\}/g) || []).length;
+    if (unlessOpens !== unlessCloses) {
+        errors.push(`- Unbalanced {{#unless}}: ${unlessOpens} opens, ${unlessCloses} closes`);
+    }
+    // Check for data-edit-key in static pages
+    if (templateType === 'static_page') {
+        const editKeys = html.match(/data-edit-key="[^"]+"/g) || [];
+        if (editKeys.length === 0) {
+            suggestions.push('- Consider adding data-edit-key attributes to make text editable in the CMS');
+        }
+    }
+    // Check asset paths
+    const wrongAssetPaths = html.match(/(href|src)=["'](?!\/public\/|https?:\/\/|#|\/\?|mailto:|tel:)[^"']+["']/g) || [];
+    for (const path of wrongAssetPaths.slice(0, 5)) { // Limit to 5 examples
+        if (!path.includes('{{') && !path.includes('data:')) {
+            warnings.push(`- Asset path may need /public/ prefix: ${path}`);
+        }
+    }
+    if (wrongAssetPaths.length > 5) {
+        warnings.push(`- ...and ${wrongAssetPaths.length - 5} more asset paths that may need /public/ prefix`);
+    }
+    // Build result
+    let output = '';
+    if (errors.length === 0 && warnings.length === 0) {
+        output = `✅ TEMPLATE VALID
+
+The ${templateType} template structure looks correct.
+
+Found:
+- ${doubleTokens.length} double-brace tokens
+- ${tripleTokens.length} triple-brace tokens
+- ${eachLoops.length} {{#each}} loop(s)
+- ${conditionals.length} {{#if}} conditional(s)`;
+        if (suggestions.length > 0) {
+            output += `
+
+Suggestions:
+${suggestions.join('\n')}`;
+        }
+    }
+    else if (errors.length === 0) {
+        output = `⚠️ TEMPLATE VALID WITH WARNINGS
+
+Warnings:
+${warnings.join('\n')}`;
+        if (suggestions.length > 0) {
+            output += `
+
+Suggestions:
+${suggestions.join('\n')}`;
+        }
+    }
+    else {
+        output = `❌ TEMPLATE HAS ERRORS
+
+Errors (must fix):
+${errors.join('\n')}`;
+        if (warnings.length > 0) {
+            output += `
+
+Warnings:
+${warnings.join('\n')}`;
+        }
+    }
+    return output;
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "multisite-cms-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for AI-assisted website conversion to CMS format. Provides validation, examples, and schema tools.",
+  "main": "dist/index.js",
+  "bin": {
+    "multisite-cms-mcp": "./dist/index.js"
+  },
+  "type": "commonjs",
+  "scripts": {
+    "build": "NODE_OPTIONS='--max-old-space-size=4096' tsc --skipLibCheck",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cms",
+    "website-conversion",
+    "ai-tools",
+    "claude",
+    "cursor",
+    "validation"
+  ],
+  "author": "Arih Goldstein",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arihgoldstein/multisite-cms.git",
+    "directory": "packages/mcp-server"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3",
+    "ts-node": "^10.9.2"
+  }
+}