@respira/wordpress-mcp-server 1.4.0

package/README.md

@@ -0,0 +1,155 @@
+# Respira WordPress MCP Server
+
+MCP (Model Context Protocol) server for connecting AI coding assistants to WordPress sites.
+
+## Installation
+
+### From npm (Coming Soon)
+
+```bash
+npm install -g @respira/wordpress-mcp-server
+```
+
+### From GitHub Releases
+
+Since the repository is private, download the MCP server from GitHub releases:
+
+1. Go to [GitHub Releases](https://github.com/webmyc/respira-wordpress/releases)
+2. Find the latest release with tag `mcp-v*` (e.g., `mcp-v1.3.1`)
+3. Download the `respira-wordpress-mcp-server-*.zip` file
+4. Extract the archive to a location on your computer (e.g., `~/.respira/mcp-server/`)
+5. The extracted folder contains the `dist/` directory with the compiled server
+
+**Note**: The repository is private, so you cannot clone it directly. Use the releases page to download pre-built packages.
+
+## Configuration
+
+### Option 1: Configuration File (Recommended)
+
+Create a configuration file at `~/.respira/config.json`:
+
+```json
+{
+  "sites": [
+    {
+      "id": "my-site",
+      "name": "My WordPress Site",
+      "url": "https://mysite.com",
+      "apiKey": "respira_your-api-key-here",
+      "default": true
+    }
+  ],
+  "preferences": {
+    "autoDuplicate": true,
+    "securityChecks": true
+  }
+}
+```
+
+### Option 2: Environment Variables
+
+Create a `.env` file:
+
+```bash
+WP_SITE_URL=https://your-wordpress-site.com
+WP_API_KEY=respira_your-api-key-here
+```
+
+## Usage
+
+### With Cursor
+
+Add to your Cursor settings (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "respira-wordpress": {
+      "command": "node",
+      "args": ["/path/to/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+### With Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "respira-wordpress": {
+      "command": "node",
+      "args": ["/path/to/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Content Management
+- `wordpress_get_site_context` - Get comprehensive site information
+- `wordpress_get_theme_docs` - Get theme documentation
+- `wordpress_get_builder_info` - Get page builder information
+- `wordpress_list_pages` - List all pages
+- `wordpress_read_page` - Get page content
+- `wordpress_create_page_duplicate` - Duplicate a page for safe editing
+- `wordpress_update_page` - Update page content
+- `wordpress_delete_page` - Delete a page
+- `wordpress_list_posts` - List all posts
+- `wordpress_read_post` - Get post content
+- `wordpress_create_post_duplicate` - Duplicate a post
+- `wordpress_list_media` - List media files
+- `wordpress_extract_builder_content` - Extract page builder content
+- `wordpress_inject_builder_content` - Inject page builder content
+- `wordpress_validate_security` - Validate content for security issues
+- `wordpress_switch_site` - Switch between multiple WordPress sites
+
+### Page Speed Analysis
+- `wordpress_analyze_performance` - Analyze page performance metrics (load time, optimization opportunities)
+- `wordpress_get_core_web_vitals` - Get Core Web Vitals scores (LCP, FID, CLS)
+- `wordpress_analyze_images` - Analyze image optimization opportunities
+
+### SEO Analysis
+- `wordpress_analyze_seo` - Comprehensive SEO analysis (meta tags, headings, alt text, linking)
+- `wordpress_check_seo_issues` - Check for common SEO issues and get recommendations
+- `wordpress_analyze_readability` - Analyze content readability (Flesch Reading Ease, sentence structure)
+
+### AI Engine Optimization (AEO)
+- `wordpress_analyze_aeo` - Analyze content for AI search engines (Perplexity, ChatGPT)
+- `wordpress_check_structured_data` - Check schema markup and structured data (JSON-LD, microdata)
+
+### Plugin Management (EXPERIMENTAL)
+- `wordpress_list_plugins` - List all installed plugins with status and version
+- `wordpress_install_plugin` - Install a plugin from WordPress.org or ZIP URL
+- `wordpress_activate_plugin` - Activate a plugin
+- `wordpress_deactivate_plugin` - Deactivate a plugin
+- `wordpress_update_plugin` - Update a plugin to the latest version
+- `wordpress_delete_plugin` - Permanently delete a plugin
+
+**Note**: Plugin management tools are EXPERIMENTAL and require the feature to be enabled in Respira settings (disabled by default for security). Use with caution and always have backups.
+
+## Development
+
+```bash
+# Watch mode
+npm run watch
+
+# Build
+npm run build
+
+# Run
+npm run start
+
+# Lint
+npm run lint
+
+# Format
+npm run format
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Configuration management
+ */
+import type { RespiraConfig, WordPressSiteConfig } from './types/index.js';
+/**
+ * Load configuration from file
+ */
+export declare function loadConfig(): RespiraConfig;
+/**
+ * Save configuration to file
+ */
+export declare function saveConfig(config: RespiraConfig): void;
+/**
+ * Add a new site to configuration
+ */
+export declare function addSite(site: WordPressSiteConfig): void;
+/**
+ * Remove a site from configuration
+ */
+export declare function removeSite(siteId: string): void;
+/**
+ * Set default site
+ */
+export declare function setDefaultSite(siteId: string): void;
+/**
+ * Test connection to a WordPress site
+ */
+export declare function testConnection(siteId: string): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAa3E;;GAEG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAkE1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAWtD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAevD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAgB/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAiBnD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlE"}

package/dist/config.js

@@ -0,0 +1,162 @@
+/**
+ * Configuration management
+ */
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CONFIG_DIR = join(homedir(), '.respira');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const DEFAULT_CONFIG = {
+    sites: [],
+    preferences: {
+        autoDuplicate: true,
+        securityChecks: true,
+    },
+};
+/**
+ * Load configuration from file
+ */
+export function loadConfig() {
+    if (!existsSync(CONFIG_FILE)) {
+        console.error('No configuration file found. Creating default configuration...');
+        console.error(`Please edit ${CONFIG_FILE} to add your WordPress sites.`);
+        // Create directory if it doesn't exist
+        if (!existsSync(CONFIG_DIR)) {
+            mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        // Create default config
+        const exampleConfig = {
+            sites: [
+                {
+                    id: 'example-site',
+                    name: 'My WordPress Site',
+                    url: 'https://example.com',
+                    apiKey: 'respira_your-api-key-here',
+                    default: true,
+                },
+            ],
+            preferences: {
+                autoDuplicate: true,
+                securityChecks: true,
+            },
+        };
+        saveConfig(exampleConfig);
+        throw new Error(`Configuration file created at ${CONFIG_FILE}\n` +
+            'Please update it with your WordPress site URL and API key, then run again.');
+    }
+    try {
+        const configData = readFileSync(CONFIG_FILE, 'utf-8');
+        const config = JSON.parse(configData);
+        // Validate configuration
+        if (!config.sites || config.sites.length === 0) {
+            throw new Error('No WordPress sites configured in config.json');
+        }
+        // Validate each site
+        config.sites.forEach((site, index) => {
+            if (!site.id || !site.name || !site.url || !site.apiKey) {
+                throw new Error(`Site ${index + 1} is missing required fields (id, name, url, apiKey)`);
+            }
+            if (!site.apiKey.startsWith('respira_')) {
+                console.warn(`Warning: API key for "${site.name}" doesn't start with "respira_" prefix`);
+            }
+        });
+        return config;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return DEFAULT_CONFIG;
+        }
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in config file: ${CONFIG_FILE}\n${error.message}`);
+        }
+        const errorMessage = error?.message || error?.toString() || 'Unknown error';
+        throw new Error(`Failed to load configuration from ${CONFIG_FILE}: ${errorMessage}`);
+    }
+}
+/**
+ * Save configuration to file
+ */
+export function saveConfig(config) {
+    try {
+        if (!existsSync(CONFIG_DIR)) {
+            mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+        console.error(`Configuration saved to ${CONFIG_FILE}`);
+    }
+    catch (error) {
+        throw new Error(`Failed to save configuration: ${error.message}`);
+    }
+}
+/**
+ * Add a new site to configuration
+ */
+export function addSite(site) {
+    const config = loadConfig();
+    // Check for duplicate ID
+    if (config.sites.some((s) => s.id === site.id)) {
+        throw new Error(`Site with ID "${site.id}" already exists`);
+    }
+    // If this is the first site, make it default
+    if (config.sites.length === 0) {
+        site.default = true;
+    }
+    config.sites.push(site);
+    saveConfig(config);
+}
+/**
+ * Remove a site from configuration
+ */
+export function removeSite(siteId) {
+    const config = loadConfig();
+    const index = config.sites.findIndex((s) => s.id === siteId);
+    if (index === -1) {
+        throw new Error(`Site with ID "${siteId}" not found`);
+    }
+    config.sites.splice(index, 1);
+    // If we removed the default site, make the first site default
+    if (config.sites.length > 0 && !config.sites.some((s) => s.default)) {
+        config.sites[0].default = true;
+    }
+    saveConfig(config);
+}
+/**
+ * Set default site
+ */
+export function setDefaultSite(siteId) {
+    const config = loadConfig();
+    const site = config.sites.find((s) => s.id === siteId);
+    if (!site) {
+        throw new Error(`Site with ID "${siteId}" not found`);
+    }
+    // Remove default from all sites
+    config.sites.forEach((s) => {
+        s.default = false;
+    });
+    // Set new default
+    site.default = true;
+    saveConfig(config);
+}
+/**
+ * Test connection to a WordPress site
+ */
+export async function testConnection(siteId) {
+    const config = loadConfig();
+    const site = config.sites.find((s) => s.id === siteId);
+    if (!site) {
+        throw new Error(`Site with ID "${siteId}" not found`);
+    }
+    const { WordPressClient } = await import('./wordpress-client.js');
+    const client = new WordPressClient(site);
+    try {
+        const context = await client.getSiteContext();
+        console.log(`✓ Connected to ${site.name}`);
+        console.log(`  WordPress: ${context.wordpress_version}`);
+        console.log(`  PHP: ${context.php_version}`);
+        console.log(`  Theme: ${context.active_theme.name}`);
+    }
+    catch (error) {
+        throw new Error(`Connection test failed: ${error.message}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/divi-context.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Divi Builder Context and Documentation
+ *
+ * Provides comprehensive Divi documentation for AI assistants.
+ */
+export declare const diviContext = "\nYou are editing a Divi Builder page. Divi uses a hierarchical structure: Sections > Rows > Modules.\n\n## Divi Structure\n\n- **Sections (et_pb_section)**: Top-level containers that hold rows\n- **Rows (et_pb_row)**: Column layout containers that hold modules\n- **Modules**: Content elements (text, images, buttons, etc.)\n\n## Common Divi Modules\n\n### Layout Modules\n- **et_pb_section**: Top-level container\n- **et_pb_row**: Column layout container\n\n### Content Modules (Tier 1 - Most Common)\n- **et_pb_text**: Text content module for paragraphs and headings\n  - Attributes: content (HTML), text_color (hex), background_color (hex), font_size (px/em)\n- **et_pb_image**: Image module\n  - Attributes: src (URL), alt (text), url (link URL), align (left/center/right)\n- **et_pb_button**: Button module\n  - Attributes: button_text (text), button_url (URL), button_alignment (left/center/right), button_bg_color (hex)\n- **et_pb_cta**: Call to action module with heading, text, and button\n  - Attributes: title (text), content (HTML), button_text (text), button_url (URL)\n- **et_pb_blurb**: Icon with text module\n  - Attributes: title (text), content (HTML), image (URL), url (link URL)\n- **et_pb_video**: Video module\n  - Attributes: src (URL - YouTube, Vimeo, or direct video), image_src (thumbnail URL)\n- **et_pb_html_content**: Custom HTML content module (supports scripts)\n  - Attributes: content (HTML - can include scripts)\n- **et_pb_code**: Custom HTML/CSS/JS module\n  - Attributes: content (base64 encoded)\n\n### Common Modules (Tier 2)\n- **et_pb_slider**: Content slider\n- **et_pb_testimonial**: Testimonial module\n- **et_pb_team_member**: Team member profile\n- **et_pb_pricing_tables**: Pricing table\n- **et_pb_contact_form**: Contact form\n- **et_pb_gallery**: Image gallery\n- **et_pb_accordion**: Accordion/toggle content\n- **et_pb_tabs**: Tabbed content\n- **et_pb_blog**: Blog posts display\n- **et_pb_portfolio**: Portfolio display\n\n## Common Attributes (Available on Most Modules)\n\n- **admin_label**: Label shown in builder for identification\n- **module_id**: Unique CSS ID for the module\n- **module_class**: Custom CSS class\n- **disabled_on**: Hide module on devices (format: \"off|off|off\" for desktop|tablet|phone)\n- **custom_css**: Custom CSS for this module\n- **background_color**: Background color (hex format: #FFFFFF)\n- **text_color**: Text color (hex format: #000000)\n- **padding**: Padding (format: \"10px|20px|10px|20px\" for top|right|bottom|left)\n- **margin**: Margin (same format as padding)\n\n## Format Specifications\n\n- **Colors**: Always use hex format (e.g., #0000FF for blue, #FFFFFF for white)\n- **Spacing**: Use format \"10px|20px|10px|20px\" (top|right|bottom|left)\n- **Sizing**: Use px, em, rem, %, or vw units\n- **Fonts**: Font names from Google Fonts or system fonts\n- **URLs**: Full URLs including https://\n\n## Common Tasks\n\n### Change Text Color\nFind the et_pb_text module and modify its text_color attribute to the desired hex color.\n\n### Update Heading\nFind the et_pb_text module containing the heading and modify its content attribute.\n\n### Add Button\nCreate an et_pb_button module with button_text and button_url attributes.\n\n### Change Background Color\nModify the background_color attribute of the section, row, or module.\n\n### Update Image\nFind the et_pb_image module and modify its src attribute to the new image URL.\n\n## Important Rules\n\n1. Modules MUST be inside rows (except sections)\n2. Rows MUST be inside sections\n3. Don't create bare modules without proper parent containers\n4. Check nesting depth (max 3 levels typical: section > row > module)\n5. Preserve all existing attributes when modifying modules\n6. Use proper attribute formats (hex for colors, URLs for links)\n";
+export declare const diviAttributeHelp: {
+    colors: string;
+    spacing: string;
+    sizing: string;
+    fonts: string;
+    urls: string;
+};
+export declare const diviValidationRules = "\nCRITICAL Divi Rules:\n1. Modules MUST be inside rows (except sections which are top-level)\n2. Rows MUST be inside sections\n3. Don't create bare modules without parents\n4. Check nesting depth (max 3 levels typical: section > row > module)\n5. Preserve module structure when modifying\n6. Always use proper attribute formats\n";
+//# sourceMappingURL=divi-context.d.ts.map

package/dist/divi-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"divi-context.d.ts","sourceRoot":"","sources":["../src/divi-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,WAAW,8tHA0FvB,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;CAM7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,8UAQ/B,CAAC"}

package/dist/divi-context.js

@@ -0,0 +1,113 @@
+/**
+ * Divi Builder Context and Documentation
+ *
+ * Provides comprehensive Divi documentation for AI assistants.
+ */
+export const diviContext = `
+You are editing a Divi Builder page. Divi uses a hierarchical structure: Sections > Rows > Modules.
+
+## Divi Structure
+
+- **Sections (et_pb_section)**: Top-level containers that hold rows
+- **Rows (et_pb_row)**: Column layout containers that hold modules
+- **Modules**: Content elements (text, images, buttons, etc.)
+
+## Common Divi Modules
+
+### Layout Modules
+- **et_pb_section**: Top-level container
+- **et_pb_row**: Column layout container
+
+### Content Modules (Tier 1 - Most Common)
+- **et_pb_text**: Text content module for paragraphs and headings
+  - Attributes: content (HTML), text_color (hex), background_color (hex), font_size (px/em)
+- **et_pb_image**: Image module
+  - Attributes: src (URL), alt (text), url (link URL), align (left/center/right)
+- **et_pb_button**: Button module
+  - Attributes: button_text (text), button_url (URL), button_alignment (left/center/right), button_bg_color (hex)
+- **et_pb_cta**: Call to action module with heading, text, and button
+  - Attributes: title (text), content (HTML), button_text (text), button_url (URL)
+- **et_pb_blurb**: Icon with text module
+  - Attributes: title (text), content (HTML), image (URL), url (link URL)
+- **et_pb_video**: Video module
+  - Attributes: src (URL - YouTube, Vimeo, or direct video), image_src (thumbnail URL)
+- **et_pb_html_content**: Custom HTML content module (supports scripts)
+  - Attributes: content (HTML - can include scripts)
+- **et_pb_code**: Custom HTML/CSS/JS module
+  - Attributes: content (base64 encoded)
+
+### Common Modules (Tier 2)
+- **et_pb_slider**: Content slider
+- **et_pb_testimonial**: Testimonial module
+- **et_pb_team_member**: Team member profile
+- **et_pb_pricing_tables**: Pricing table
+- **et_pb_contact_form**: Contact form
+- **et_pb_gallery**: Image gallery
+- **et_pb_accordion**: Accordion/toggle content
+- **et_pb_tabs**: Tabbed content
+- **et_pb_blog**: Blog posts display
+- **et_pb_portfolio**: Portfolio display
+
+## Common Attributes (Available on Most Modules)
+
+- **admin_label**: Label shown in builder for identification
+- **module_id**: Unique CSS ID for the module
+- **module_class**: Custom CSS class
+- **disabled_on**: Hide module on devices (format: "off|off|off" for desktop|tablet|phone)
+- **custom_css**: Custom CSS for this module
+- **background_color**: Background color (hex format: #FFFFFF)
+- **text_color**: Text color (hex format: #000000)
+- **padding**: Padding (format: "10px|20px|10px|20px" for top|right|bottom|left)
+- **margin**: Margin (same format as padding)
+
+## Format Specifications
+
+- **Colors**: Always use hex format (e.g., #0000FF for blue, #FFFFFF for white)
+- **Spacing**: Use format "10px|20px|10px|20px" (top|right|bottom|left)
+- **Sizing**: Use px, em, rem, %, or vw units
+- **Fonts**: Font names from Google Fonts or system fonts
+- **URLs**: Full URLs including https://
+
+## Common Tasks
+
+### Change Text Color
+Find the et_pb_text module and modify its text_color attribute to the desired hex color.
+
+### Update Heading
+Find the et_pb_text module containing the heading and modify its content attribute.
+
+### Add Button
+Create an et_pb_button module with button_text and button_url attributes.
+
+### Change Background Color
+Modify the background_color attribute of the section, row, or module.
+
+### Update Image
+Find the et_pb_image module and modify its src attribute to the new image URL.
+
+## Important Rules
+
+1. Modules MUST be inside rows (except sections)
+2. Rows MUST be inside sections
+3. Don't create bare modules without proper parent containers
+4. Check nesting depth (max 3 levels typical: section > row > module)
+5. Preserve all existing attributes when modifying modules
+6. Use proper attribute formats (hex for colors, URLs for links)
+`;
+export const diviAttributeHelp = {
+    colors: 'Use hex format: #0000FF (no rgb() or color names)',
+    spacing: 'Use format: 10px|20px|10px|20px (top|right|bottom|left)',
+    sizing: 'Use px, em, rem, %, or vw units',
+    fonts: 'Font names from Google Fonts or system fonts',
+    urls: 'Full URLs including https:// protocol',
+};
+export const diviValidationRules = `
+CRITICAL Divi Rules:
+1. Modules MUST be inside rows (except sections which are top-level)
+2. Rows MUST be inside sections
+3. Don't create bare modules without parents
+4. Check nesting depth (max 3 levels typical: section > row > module)
+5. Preserve module structure when modifying
+6. Always use proper attribute formats
+`;
+//# sourceMappingURL=divi-context.js.map

package/dist/divi-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"divi-context.js","sourceRoot":"","sources":["../src/divi-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0F1B,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,mDAAmD;IAC3D,OAAO,EAAE,yDAAyD;IAClE,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE,8CAA8C;IACrD,IAAI,EAAE,uCAAuC;CAC9C,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;CAQlC,CAAC"}

package/dist/divi-prompts.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Divi Builder Prompt Templates
+ *
+ * Pre-built prompt expansions for common Divi editing tasks.
+ */
+export interface DiviPrompt {
+    name: string;
+    description: string;
+    template: string;
+}
+export declare const diviPrompts: Record<string, DiviPrompt>;
+export declare const diviCommonAttributes: string[];
+export declare function getDiviPrompt(name: string): DiviPrompt | undefined;
+export declare function expandDiviPrompt(promptName: string, variables: Record<string, string>): string;
+//# sourceMappingURL=divi-prompts.d.ts.map

package/dist/divi-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"divi-prompts.d.ts","sourceRoot":"","sources":["../src/divi-prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAwFlD,CAAC;AAEF,eAAO,MAAM,oBAAoB,UAShC,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAYR"}

package/dist/divi-prompts.js

@@ -0,0 +1,114 @@
+/**
+ * Divi Builder Prompt Templates
+ *
+ * Pre-built prompt expansions for common Divi editing tasks.
+ */
+export const diviPrompts = {
+    createHeroSection: {
+        name: 'create_divi_hero',
+        description: 'Create a Divi hero section with background and CTA',
+        template: `Create a Divi section with:
+- Background image or color
+- Centered text module with heading
+- Button module for CTA
+
+Structure:
+[et_pb_section background_image="{bg_url}" background_color="{bg_color}"]
+  [et_pb_row]
+    [et_pb_text text_orientation="center"]
+      <h1>{heading}</h1>
+      <p>{subheading}</p>
+    [/et_pb_text]
+    [et_pb_button button_url="{url}" button_text="{text}" button_alignment="center"]
+    [/et_pb_button]
+  [/et_pb_row]
+[/et_pb_section]`,
+    },
+    updateModuleStyle: {
+        name: 'update_divi_style',
+        description: 'Update visual styling of a Divi module',
+        template: `To update module styling, modify these common attributes:
+- background_color: Use hex format (e.g., #0000FF)
+- text_color: Use hex format (e.g., #FFFFFF)
+- border_radius: Use px or % (e.g., 10px or 50%)
+- padding: Use format "10px|20px|10px|20px" (top|right|bottom|left)
+- margin: Same format as padding
+
+Example: To make text blue, set text_color="#0000FF"`,
+    },
+    updateTextContent: {
+        name: 'update_divi_text',
+        description: 'Update text content in a Divi text module',
+        template: `Find the et_pb_text module and modify its content attribute.
+Content can include HTML tags like <h1>, <p>, <strong>, <em>, etc.
+
+Example:
+- Original: <h1>Old Heading</h1>
+- Updated: <h1>New Heading</h1>`,
+    },
+    addButton: {
+        name: 'add_divi_button',
+        description: 'Add a button module to a Divi page',
+        template: `Create an et_pb_button module with:
+- button_text: The button label
+- button_url: The link URL
+- button_alignment: left, center, or right
+- button_bg_color: Background color (hex format)
+- button_text_color: Text color (hex format)
+
+Example:
+[et_pb_button button_text="Click Here" button_url="https://example.com" button_alignment="center" button_bg_color="#0000FF" button_text_color="#FFFFFF"]
+[/et_pb_button]`,
+    },
+    updateImage: {
+        name: 'update_divi_image',
+        description: 'Update an image in a Divi image module',
+        template: `Find the et_pb_image module and modify:
+- src: New image URL
+- alt: Image alt text (for accessibility)
+- url: Optional link URL if image should be clickable
+- align: left, center, or right
+
+Example:
+[et_pb_image src="https://example.com/new-image.jpg" alt="Description" align="center"]
+[/et_pb_image]`,
+    },
+    changeColors: {
+        name: 'change_divi_colors',
+        description: 'Change colors in Divi modules',
+        template: `To change colors:
+1. Find the module (section, row, or content module)
+2. Modify the color attribute:
+   - text_color: For text color (hex format)
+   - background_color: For background color (hex format)
+   - button_bg_color: For button background
+   - button_text_color: For button text
+
+Always use hex format: #RRGGBB (e.g., #0000FF for blue)`,
+    },
+};
+export const diviCommonAttributes = [
+    'background_color',
+    'text_color',
+    'border_radius',
+    'padding',
+    'margin',
+    'admin_label',
+    'module_id',
+    'module_class',
+];
+export function getDiviPrompt(name) {
+    return diviPrompts[name];
+}
+export function expandDiviPrompt(promptName, variables) {
+    const prompt = diviPrompts[promptName];
+    if (!prompt) {
+        return '';
+    }
+    let expanded = prompt.template;
+    Object.entries(variables).forEach(([key, value]) => {
+        expanded = expanded.replace(new RegExp(`\\{${key}\\}`, 'g'), value);
+    });
+    return expanded;
+}
+//# sourceMappingURL=divi-prompts.js.map

package/dist/divi-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"divi-prompts.js","sourceRoot":"","sources":["../src/divi-prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,CAAC,MAAM,WAAW,GAA+B;IACrD,iBAAiB,EAAE;QACjB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE;;;;;;;;;;;;;;;iBAeG;KACd;IAED,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE;;;;;;;qDAOuC;KAClD;IAED,iBAAiB,EAAE;QACjB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,2CAA2C;QACxD,QAAQ,EAAE;;;;;gCAKkB;KAC7B;IAED,SAAS,EAAE;QACT,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,oCAAoC;QACjD,QAAQ,EAAE;;;;;;;;;gBASE;KACb;IAED,WAAW,EAAE;QACX,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE;;;;;;;;eAQC;KACZ;IAED,YAAY,EAAE;QACZ,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,+BAA+B;QAC5C,QAAQ,EAAE;;;;;;;;wDAQ0C;KACrD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,kBAAkB;IAClB,YAAY;IACZ,eAAe;IACf,SAAS;IACT,QAAQ;IACR,aAAa;IACb,WAAW;IACX,cAAc;CACf,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,SAAiC;IAEjC,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/B,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACjD,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Respira WordPress MCP Server
+ * Entry point
+ */
+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":";AAEA;;;GAGG"}