multisite-cms-mcp 1.0.0

package/README.md

@@ -0,0 +1,126 @@
+# Multisite CMS MCP Server
+
+An MCP (Model Context Protocol) server that helps AI agents convert websites into CMS-compatible packages. Provides validation, examples, and schema information.
+
+## Installation
+
+### Using npx (Recommended)
+
+Add to your MCP configuration (e.g., `.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "multisite-cms": {
+      "command": "npx",
+      "args": ["-y", "multisite-cms-mcp"]
+    }
+  }
+}
+```
+
+### Global Installation
+
+```bash
+npm install -g multisite-cms-mcp
+```
+
+Then configure:
+
+```json
+{
+  "mcpServers": {
+    "multisite-cms": {
+      "command": "multisite-cms-mcp"
+    }
+  }
+}
+```
+
+## Available Tools
+
+### `get_schema`
+Get the complete CMS schema including all built-in collections and their fields.
+
+```
+AI: What fields are available for blog posts?
+[calls get_schema]
+```
+
+### `validate_manifest`
+Validate a manifest.json file structure.
+
+**Parameters:**
+- `manifest` (string): The manifest.json content
+
+```
+AI: Let me check if this manifest is valid...
+[calls validate_manifest with JSON string]
+```
+
+### `validate_template`
+Check HTML templates for correct token usage.
+
+**Parameters:**
+- `html` (string): The template HTML content
+- `templateType` (string): One of: `blog_index`, `blog_post`, `team`, `downloads`, `authors_index`, `author_detail`, `custom_index`, `custom_detail`, `static_page`
+- `collectionSlug` (string, optional): For custom collections
+
+```
+AI: Let me validate this blog template...
+[calls validate_template]
+
+Response: ❌ TEMPLATE HAS ERRORS
+- Wrong token: {{title}} → Use name (for blog posts)
+- {{postBody}} must use triple braces {{{postBody}}}
+```
+
+### `validate_package`
+Full package structure validation.
+
+**Parameters:**
+- `fileList` (string[]): All file paths in the package
+- `manifestContent` (string): The manifest.json content
+- `templateContentsJson` (string, optional): JSON object mapping template paths to contents
+
+### `get_example`
+Get code examples for specific patterns.
+
+**Parameters:**
+- `exampleType` (string): One of:
+  - `manifest_basic`, `manifest_custom_paths`
+  - `blog_index_template`, `blog_post_template`
+  - `team_template`, `downloads_template`
+  - `authors_template`, `author_detail_template`
+  - `custom_collection_template`
+  - `form_handling`, `asset_paths`, `data_edit_keys`
+  - `each_loop`, `conditional_if`, `nested_fields`, `featured_posts`
+
+### `get_conversion_guide`
+Get the complete conversion documentation.
+
+**Parameters:**
+- `section` (string, optional): One of: `full`, `analysis`, `structure`, `manifest`, `templates`, `tokens`, `forms`, `assets`, `checklist`
+
+## Workflow Example
+
+When converting a website, an AI agent can:
+
+1. **Start** → Call `get_conversion_guide` for requirements
+2. **Check fields** → Call `get_schema` to see exact token names
+3. **Need example?** → Call `get_example` for specific pattern
+4. **Create manifest** → Call `validate_manifest` to check it
+5. **Create template** → Call `validate_template` to verify tokens
+6. **Final check** → Call `validate_package` for full validation
+
+## Key Benefits
+
+- **Validates as you work** - Catch errors during conversion, not after
+- **Correct field names** - No more guessing `{{title}}` vs `{{name}}`
+- **Triple brace reminders** - Ensures rich text uses `{{{...}}}`
+- **Structure validation** - Confirms package layout is correct
+
+## License
+
+MIT
+

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const get_schema_1 = require("./tools/get-schema");
+const validate_manifest_1 = require("./tools/validate-manifest");
+const validate_template_1 = require("./tools/validate-template");
+const validate_package_1 = require("./tools/validate-package");
+const get_example_1 = require("./tools/get-example");
+const get_conversion_guide_1 = require("./tools/get-conversion-guide");
+const server = new index_js_1.Server({
+    name: 'multisite-cms',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Define available tools
+const TOOLS = [
+    {
+        name: 'get_schema',
+        description: 'Get the complete CMS schema including all built-in and custom collections with their fields. Use this to understand what content types are available and what tokens to use in templates.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'validate_manifest',
+        description: 'Validate a manifest.json file for the CMS package. Returns errors if the structure is incorrect or required fields are missing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                manifest: {
+                    type: 'string',
+                    description: 'The manifest.json content as a string',
+                },
+            },
+            required: ['manifest'],
+        },
+    },
+    {
+        name: 'validate_template',
+        description: 'Validate an HTML template for correct CMS token usage. Checks for proper {{token}} syntax, correct field names, and proper use of triple braces for rich text.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                html: {
+                    type: 'string',
+                    description: 'The HTML template content',
+                },
+                templateType: {
+                    type: 'string',
+                    enum: ['blog_index', 'blog_post', 'team', 'downloads', 'authors_index', 'author_detail', 'custom_index', 'custom_detail', 'static_page'],
+                    description: 'The type of template being validated',
+                },
+                collectionSlug: {
+                    type: 'string',
+                    description: 'For custom collections, the collection slug',
+                },
+            },
+            required: ['html', 'templateType'],
+        },
+    },
+    {
+        name: 'validate_package',
+        description: 'Validate the complete structure of a CMS website package. Checks folder structure, manifest, all templates, and asset references.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                fileList: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of all file paths in the package',
+                },
+                manifestContent: {
+                    type: 'string',
+                    description: 'Content of manifest.json',
+                },
+                templateContentsJson: {
+                    type: 'string',
+                    description: 'JSON string mapping template file paths to their contents',
+                },
+            },
+            required: ['fileList', 'manifestContent'],
+        },
+    },
+    {
+        name: 'get_example',
+        description: 'Get example code for a specific pattern or use case. Use this when you need to see how something should be implemented.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                exampleType: {
+                    type: 'string',
+                    enum: [
+                        'manifest_basic',
+                        'manifest_custom_paths',
+                        'blog_index_template',
+                        'blog_post_template',
+                        'team_template',
+                        'downloads_template',
+                        'authors_template',
+                        'author_detail_template',
+                        'custom_collection_template',
+                        'form_handling',
+                        'asset_paths',
+                        'data_edit_keys',
+                        'each_loop',
+                        'conditional_if',
+                        'nested_fields',
+                        'featured_posts',
+                    ],
+                    description: 'The type of example to retrieve',
+                },
+            },
+            required: ['exampleType'],
+        },
+    },
+    {
+        name: 'get_conversion_guide',
+        description: 'Get the complete website conversion guide. Use this at the start of a conversion project to understand all requirements.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                section: {
+                    type: 'string',
+                    enum: ['full', 'analysis', 'structure', 'manifest', 'templates', 'tokens', 'forms', 'assets', 'checklist'],
+                    description: 'Specific section to retrieve, or "full" for everything',
+                },
+            },
+            required: [],
+        },
+    },
+];
+// Handle list tools request
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+// Handle tool calls
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const params = args;
+    try {
+        let result;
+        switch (name) {
+            case 'get_schema':
+                result = await (0, get_schema_1.getSchema)();
+                break;
+            case 'validate_manifest':
+                result = await (0, validate_manifest_1.validateManifest)(params.manifest);
+                break;
+            case 'validate_template':
+                result = await (0, validate_template_1.validateTemplate)(params.html, params.templateType, params.collectionSlug);
+                break;
+            case 'validate_package': {
+                let templateContents;
+                if (params.templateContentsJson) {
+                    try {
+                        templateContents = JSON.parse(params.templateContentsJson);
+                    }
+                    catch {
+                        templateContents = undefined;
+                    }
+                }
+                result = await (0, validate_package_1.validatePackage)(params.fileList, params.manifestContent, templateContents);
+                break;
+            }
+            case 'get_example':
+                result = await (0, get_example_1.getExample)(params.exampleType);
+                break;
+            case 'get_conversion_guide':
+                result = await (0, get_conversion_guide_1.getConversionGuide)(params.section || 'full');
+                break;
+            default:
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+        }
+        return {
+            content: [{ type: 'text', text: result }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Multisite CMS MCP Server running on stdio');
+}
+main().catch(console.error);

package/dist/tools/get-conversion-guide.d.ts

@@ -0,0 +1,7 @@
+type Section = 'full' | 'analysis' | 'structure' | 'manifest' | 'templates' | 'tokens' | 'forms' | 'assets' | 'checklist';
+/**
+ * Returns the conversion guide, either full or a specific section
+ */
+export declare function getConversionGuide(section: Section): Promise<string>;
+export {};
+//# sourceMappingURL=get-conversion-guide.d.ts.map

package/dist/tools/get-conversion-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAoe1H;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}