@wplaunchify/ml-mcp-server 2.1.4 → 2.4.4

package/build/tools/index.js

@@ -11,6 +11,7 @@ import { fluentCommunityLayoutTools, fluentCommunityLayoutHandlers } from './flu
 import { fluentCartTools, fluentCartHandlers } from './fluent-cart.js';
 import { fluentCRMTools, fluentCRMHandlers } from './fluent-crm.js';
 import { mlCanvasTools, mlCanvasHandlers } from './ml-canvas.js';
+import { mlSimpleSiteTools, mlSimpleSiteHandlers } from './ml-simple-site.js';
 import { mlImageEditorTools, mlImageEditorHandlers } from './ml-image-editor.js';
 import { fluentAffiliateTools, fluentAffiliateHandlers } from './fluent-affiliate.js';
 import { mlMediaHubTools, mlMediaHubHandlers } from './ml-media-hub.js';
@@ -32,7 +33,8 @@ const toolCategories = {
         ...userTools,
         ...pluginRepositoryTools,
         ...commentTools,
-        ...mlCanvasTools
+        ...mlCanvasTools,
+        ...mlSimpleSiteTools
     ],
     // Full FluentCommunity (91 tools) - legacy support
     fluentcommunity: [
@@ -74,7 +76,7 @@ const toolCategories = {
     ]
 };
 const handlerCategories = {
-    // WP (ENABLED_TOOLS=wordpress) - 40 tools
+    // WP (ENABLED_TOOLS=wordpress) - 45 tools
     wordpress: {
         ...unifiedContentHandlers,
         ...unifiedTaxonomyHandlers,
@@ -83,7 +85,8 @@ const handlerCategories = {
         ...userHandlers,
         ...pluginRepositoryHandlers,
         ...commentHandlers,
-        ...mlCanvasHandlers // ML Canvas is part of WordPress category
+        ...mlCanvasHandlers, // ML Canvas is part of WordPress category
+        ...mlSimpleSiteHandlers // ML Simple Site tools
     },
     fluentcommunity: {
         ...fluentCommunityHandlers,

package/build/tools/media.d.ts

@@ -61,6 +61,25 @@ declare const deleteMediaSchema: z.ZodObject<{
     id: number;
     force?: boolean | undefined;
 }>;
+declare const uploadMediaSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    alt_text: z.ZodOptional<z.ZodString>;
+    caption: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    file_path: string;
+    title?: string | undefined;
+    description?: string | undefined;
+    alt_text?: string | undefined;
+    caption?: string | undefined;
+}, {
+    file_path: string;
+    title?: string | undefined;
+    description?: string | undefined;
+    alt_text?: string | undefined;
+    caption?: string | undefined;
+}>;
 export declare const mediaTools: Tool[];
 export declare const mediaHandlers: {
     list_media: (params: z.infer<typeof listMediaSchema>) => Promise<{
@@ -97,6 +116,23 @@ export declare const mediaHandlers: {
             }[];
         };
     }>;
+    upload_media: (params: z.infer<typeof uploadMediaSchema>) => Promise<{
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    } | {
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    }>;
     edit_media: (params: z.infer<typeof editMediaSchema>) => Promise<{
         toolResult: {
             content: {

package/build/tools/media.js

@@ -27,6 +27,14 @@ const deleteMediaSchema = z.object({
     id: z.number().describe("Media ID to delete"),
     force: z.boolean().optional().describe("Force deletion bypassing trash")
 }).strict();
+// Schema for uploading a local file to WordPress media library
+const uploadMediaSchema = z.object({
+    file_path: z.string().describe("Local file path to upload"),
+    title: z.string().optional().describe("Media title"),
+    alt_text: z.string().optional().describe("Alternate text for the media"),
+    caption: z.string().optional().describe("Caption of the media"),
+    description: z.string().optional().describe("Description of the media")
+}).strict();
 // Define the tool set for media operations
 export const mediaTools = [
     {
@@ -39,6 +47,11 @@ export const mediaTools = [
         description: "Creates a new media item",
         inputSchema: { type: "object", properties: createMediaSchema.shape }
     },
+    {
+        name: "upload_media",
+        description: "Uploads a local file to WordPress media library",
+        inputSchema: { type: "object", properties: uploadMediaSchema.shape }
+    },
     {
         name: "edit_media",
         description: "Updates an existing media item",
@@ -125,6 +138,61 @@ export const mediaHandlers = {
             };
         }
     },
+    upload_media: async (params) => {
+        try {
+            const fs = await import('fs');
+            const path = await import('path');
+            const axios = (await import('axios')).default;
+            const FormData = (await import('form-data')).default;
+            // Check if file exists
+            if (!fs.existsSync(params.file_path)) {
+                return {
+                    toolResult: {
+                        isError: true,
+                        content: [{ type: "text", text: `File not found: ${params.file_path}` }]
+                    }
+                };
+            }
+            // Read the file
+            const fileBuffer = fs.readFileSync(params.file_path);
+            const fileName = path.basename(params.file_path);
+            // Create form data
+            const form = new FormData();
+            form.append('file', fileBuffer, {
+                filename: fileName,
+                contentType: 'application/octet-stream'
+            });
+            // Append additional fields if provided
+            if (params.title)
+                form.append('title', params.title);
+            if (params.alt_text)
+                form.append('alt_text', params.alt_text);
+            if (params.caption)
+                form.append('caption', params.caption);
+            if (params.description)
+                form.append('description', params.description);
+            // Upload to WordPress via our custom endpoint
+            const response = await makeWordPressRequest('POST', 'fc-manager/v1/wordpress/media/upload', form, {
+                isFormData: true,
+                headers: form.getHeaders(),
+                rawResponse: true
+            });
+            return {
+                toolResult: {
+                    content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }]
+                }
+            };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{ type: "text", text: `Error uploading media: ${errorMessage}` }]
+                }
+            };
+        }
+    },
     edit_media: async (params) => {
         try {
             const { id, ...updateData } = params;

package/build/tools/ml-simple-site.d.ts

@@ -0,0 +1,196 @@
+import { z } from 'zod';
+export declare const mlSimpleSiteTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            settings: z.ZodObject<{
+                site_mode: z.ZodOptional<z.ZodEnum<["single", "multi"]>>;
+                site_title: z.ZodOptional<z.ZodString>;
+                logo_url: z.ZodOptional<z.ZodString>;
+                primary_color: z.ZodOptional<z.ZodString>;
+                display_location: z.ZodOptional<z.ZodEnum<["disabled", "homepage", "page"]>>;
+                display_page_id: z.ZodOptional<z.ZodNumber>;
+                show_header: z.ZodOptional<z.ZodEnum<["yes", "no"]>>;
+                nav_style: z.ZodOptional<z.ZodEnum<["fixed", "static"]>>;
+                header_height: z.ZodOptional<z.ZodNumber>;
+                header_bg: z.ZodOptional<z.ZodString>;
+                nav_link_color: z.ZodOptional<z.ZodString>;
+                nav_font: z.ZodOptional<z.ZodString>;
+                nav_font_size: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                logo_url?: string | undefined;
+                site_title?: string | undefined;
+                site_mode?: "single" | "multi" | undefined;
+                primary_color?: string | undefined;
+                display_location?: "page" | "disabled" | "homepage" | undefined;
+                display_page_id?: number | undefined;
+                show_header?: "yes" | "no" | undefined;
+                nav_style?: "fixed" | "static" | undefined;
+                header_height?: number | undefined;
+                header_bg?: string | undefined;
+                nav_link_color?: string | undefined;
+                nav_font?: string | undefined;
+                nav_font_size?: number | undefined;
+            }, {
+                logo_url?: string | undefined;
+                site_title?: string | undefined;
+                site_mode?: "single" | "multi" | undefined;
+                primary_color?: string | undefined;
+                display_location?: "page" | "disabled" | "homepage" | undefined;
+                display_page_id?: number | undefined;
+                show_header?: "yes" | "no" | undefined;
+                nav_style?: "fixed" | "static" | undefined;
+                header_height?: number | undefined;
+                header_bg?: string | undefined;
+                nav_link_color?: string | undefined;
+                nav_font?: string | undefined;
+                nav_font_size?: number | undefined;
+            }>;
+            blocks: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                html: z.ZodString;
+                css: z.ZodOptional<z.ZodString>;
+                hide_from_nav: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                html: string;
+                css?: string | undefined;
+                hide_from_nav?: boolean | undefined;
+            }, {
+                name: string;
+                html: string;
+                css?: string | undefined;
+                hide_from_nav?: boolean | undefined;
+            }>, "many">;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            site_mode: z.ZodOptional<z.ZodEnum<["single", "multi"]>>;
+            site_title: z.ZodOptional<z.ZodString>;
+            logo_url: z.ZodOptional<z.ZodString>;
+            primary_color: z.ZodOptional<z.ZodString>;
+            display_location: z.ZodOptional<z.ZodEnum<["disabled", "homepage", "page"]>>;
+            display_page_id: z.ZodOptional<z.ZodNumber>;
+            show_header: z.ZodOptional<z.ZodEnum<["yes", "no"]>>;
+            nav_style: z.ZodOptional<z.ZodEnum<["fixed", "static"]>>;
+            header_height: z.ZodOptional<z.ZodNumber>;
+            header_bg: z.ZodOptional<z.ZodString>;
+            nav_link_color: z.ZodOptional<z.ZodString>;
+            nav_font: z.ZodOptional<z.ZodString>;
+            nav_font_size: z.ZodOptional<z.ZodNumber>;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            name: z.ZodString;
+            html: z.ZodString;
+            css: z.ZodOptional<z.ZodString>;
+            hide_from_nav: z.ZodOptional<z.ZodBoolean>;
+        };
+    };
+})[];
+export declare const mlSimpleSiteHandlers: {
+    mlss_get_site: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    mlss_save_site: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    mlss_update_settings: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    mlss_add_block: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    mlss_get_preview_url: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+};

package/build/tools/ml-simple-site.js

@@ -0,0 +1,194 @@
+import { z } from 'zod';
+import { makeWordPressRequest } from '../wordpress.js';
+// ML Simple Site Tools - Complete Website Creation via MCP
+// Requires ML Simple Site plugin v1.6.0+ on WordPress
+export const mlSimpleSiteTools = [
+    {
+        name: 'mlss_get_site',
+        description: 'Get the complete ML Simple Site configuration including settings, blocks, and preview URL',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'mlss_save_site',
+        description: 'Save complete ML Simple Site - settings and all blocks at once. Use this to create or replace an entire site. Perfect for generating personalized websites from CRM contact data.',
+        inputSchema: { type: 'object', properties: z.object({
+                settings: z.object({
+                    site_mode: z.enum(['single', 'multi']).optional().describe('single=scroll page, multi=separate pages'),
+                    site_title: z.string().optional().describe('Site title displayed in header'),
+                    logo_url: z.string().optional().describe('URL to logo image'),
+                    primary_color: z.string().optional().describe('Hex color like #2563eb'),
+                    display_location: z.enum(['disabled', 'homepage', 'page']).optional().describe('Where to display the site'),
+                    display_page_id: z.number().optional().describe('Page ID when display_location is page'),
+                    show_header: z.enum(['yes', 'no']).optional().describe('Show site header'),
+                    nav_style: z.enum(['fixed', 'static']).optional().describe('Navigation style'),
+                    header_height: z.number().optional().describe('Header height in pixels'),
+                    header_bg: z.string().optional().describe('Header background color (hex)'),
+                    nav_link_color: z.string().optional().describe('Navigation link color (hex)'),
+                    nav_font: z.string().optional().describe('Navigation font family'),
+                    nav_font_size: z.number().optional().describe('Navigation font size in pixels'),
+                }).describe('Site settings object'),
+                blocks: z.array(z.object({
+                    name: z.string().describe('Block name (appears in nav)'),
+                    html: z.string().describe('HTML content'),
+                    css: z.string().optional().describe('CSS styles'),
+                    hide_from_nav: z.boolean().optional().describe('Hide from navigation menu'),
+                })).describe('Array of content blocks'),
+            }).shape },
+    },
+    {
+        name: 'mlss_update_settings',
+        description: 'Update ML Simple Site settings. Supports partial updates - only specify fields you want to change.',
+        inputSchema: { type: 'object', properties: z.object({
+                site_mode: z.enum(['single', 'multi']).optional().describe('single=scroll page, multi=separate pages'),
+                site_title: z.string().optional().describe('Site title displayed in header'),
+                logo_url: z.string().optional().describe('URL to logo image'),
+                primary_color: z.string().optional().describe('Hex color like #FF6B35'),
+                display_location: z.enum(['disabled', 'homepage', 'page']).optional().describe('Where to display the site'),
+                display_page_id: z.number().optional().describe('Page ID when display_location is page'),
+                show_header: z.enum(['yes', 'no']).optional().describe('Show site header'),
+                nav_style: z.enum(['fixed', 'static']).optional().describe('Navigation style'),
+                header_height: z.number().optional().describe('Header height in pixels'),
+                header_bg: z.string().optional().describe('Header background color (hex)'),
+                nav_link_color: z.string().optional().describe('Navigation link color (hex)'),
+                nav_font: z.string().optional().describe('Navigation font family'),
+                nav_font_size: z.number().optional().describe('Navigation font size in pixels'),
+            }).shape },
+    },
+    {
+        name: 'mlss_add_block',
+        description: 'Add a single content block to ML Simple Site. Block is appended to the end.',
+        inputSchema: { type: 'object', properties: z.object({
+                name: z.string().describe('Block name (appears in navigation)'),
+                html: z.string().describe('HTML content for the block'),
+                css: z.string().optional().describe('CSS styles for the block'),
+                hide_from_nav: z.boolean().optional().describe('Hide from navigation menu (default false)'),
+            }).shape },
+    },
+    {
+        name: 'mlss_get_preview_url',
+        description: 'Get the frontend preview URL for the ML Simple Site',
+        inputSchema: { type: 'object', properties: {} },
+    },
+];
+export const mlSimpleSiteHandlers = {
+    mlss_get_site: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', 'mlss/v1/site');
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error getting site: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+    mlss_save_site: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'mlss/v1/site', args);
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error saving site: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+    mlss_update_settings: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'mlss/v1/settings', args);
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error updating settings: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+    mlss_add_block: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'mlss/v1/blocks/add', args);
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error adding block: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+    mlss_get_preview_url: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', 'mlss/v1/preview-url');
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error getting preview URL: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wplaunchify/ml-mcp-server",
-  "version": "2.1.4",
+  "version": "2.4.4",
   "description": "Universal MCP Server for WordPress + Fluent Suite (Community, CRM, Cart) + MinuteLaunch Plugins. Comprehensive tools for AI-powered WordPress management via Claude, Cursor, and other MCP clients.",
   "type": "module",
   "main": "./build/server.js",