sitebay-mcp 0.1.1751179164__py3-none-any.whl

sitebay_mcp/tools/__init__.py

@@ -0,0 +1,5 @@
+"""
+SiteBay MCP Tools
+
+This package contains all the MCP tool implementations for SiteBay functionality.
+"""

sitebay_mcp/tools/operations.py

@@ -0,0 +1,285 @@
+"""
+Site operations tools for SiteBay MCP Server
+"""
+
+from typing import Optional, List, Dict, Any
+from ..client import SiteBayClient
+from ..exceptions import SiteBayError
+
+
+async def sitebay_site_shell_command(
+    client: SiteBayClient,
+    fqdn: str,
+    command: str
+) -> str:
+    """
+    Execute a shell command on a WordPress site (including WP-CLI commands).
+    
+    Args:
+        fqdn: The fully qualified domain name of the site
+        command: The shell command to execute (e.g., "wp plugin list")
+    
+    Returns:
+        Command output or error message
+    """
+    try:
+        result = await client.execute_shell_command(fqdn, command)
+        
+        # Handle different response formats
+        if isinstance(result, dict):
+            if 'output' in result:
+                output = result['output']
+            elif 'result' in result:
+                output = result['result']
+            else:
+                output = str(result)
+        else:
+            output = str(result)
+        
+        response = f"**Command executed on {fqdn}:**\n"
+        response += f"```bash\n{command}\n```\n\n"
+        response += f"**Output:**\n```\n{output}\n```"
+        
+        return response
+        
+    except SiteBayError as e:
+        return f"Error executing command on {fqdn}: {str(e)}"
+
+
+async def sitebay_site_edit_file(
+    client: SiteBayClient,
+    fqdn: str,
+    file_path: str,
+    content: str
+) -> str:
+    """
+    Edit a file in the site's wp-content directory.
+    
+    Args:
+        fqdn: The fully qualified domain name of the site
+        file_path: Path to the file relative to wp-content (e.g., "themes/mytheme/style.css")
+        content: New content for the file
+    
+    Returns:
+        Success message or error
+    """
+    try:
+        result = await client.edit_file(fqdn, file_path, content)
+        
+        response = f"✅ **File Updated Successfully**\n\n"
+        response += f"• **Site**: {fqdn}\n"
+        response += f"• **File**: wp-content/{file_path}\n"
+        response += f"• **Content Length**: {len(content)} characters\n"
+        
+        if isinstance(result, str) and result:
+            response += f"\n**Server Response:**\n```\n{result}\n```"
+        
+        return response
+        
+    except SiteBayError as e:
+        return f"Error editing file on {fqdn}: {str(e)}"
+
+
+async def sitebay_site_get_events(
+    client: SiteBayClient,
+    fqdn: str,
+    after_datetime: Optional[str] = None,
+    limit: int = 20
+) -> str:
+    """
+    Get recent events for a site (deployments, updates, restores, etc.).
+    
+    Args:
+        fqdn: The fully qualified domain name of the site
+        after_datetime: Optional datetime to filter events after (ISO format)
+        limit: Maximum number of events to return (default: 20)
+    
+    Returns:
+        Formatted list of site events
+    """
+    try:
+        events = await client.get_site_events(fqdn, after_datetime)
+        
+        if not events:
+            return f"No events found for {fqdn}."
+        
+        # Limit the results
+        events = events[:limit]
+        
+        result = f"**Recent Events for {fqdn}** (showing {len(events)} events):\n\n"
+        
+        for event in events:
+            result += f"• **{event.get('event_type', 'Unknown Event')}**\n"
+            result += f"  - Time: {event.get('created_at', 'Unknown')}\n"
+            result += f"  - Status: {event.get('status', 'Unknown')}\n"
+            
+            if event.get('description'):
+                result += f"  - Description: {event.get('description')}\n"
+            
+            if event.get('metadata'):
+                metadata = event.get('metadata')
+                for key, value in metadata.items():
+                    result += f"  - {key.title()}: {value}\n"
+            
+            result += "\n"
+        
+        return result
+        
+    except SiteBayError as e:
+        return f"Error getting events for {fqdn}: {str(e)}"
+
+
+async def sitebay_site_external_path_list(
+    client: SiteBayClient,
+    fqdn: str
+) -> str:
+    """
+    List external path configurations for a site.
+    
+    Args:
+        fqdn: The fully qualified domain name of the site
+    
+    Returns:
+        List of external path configurations
+    """
+    try:
+        paths = await client.list_external_paths(fqdn)
+        
+        if not paths:
+            return f"No external paths configured for {fqdn}."
+        
+        result = f"**External Paths for {fqdn}**:\n\n"
+        
+        for path in paths:
+            result += f"• **Path**: {path.get('path', 'Unknown')}\n"
+            result += f"  - Target URL: {path.get('target_url', 'Unknown')}\n"
+            result += f"  - Status: {path.get('status', 'Unknown')}\n"
+            result += f"  - Created: {path.get('created_at', 'Unknown')}\n"
+            result += f"  - ID: {path.get('id', 'Unknown')}\n"
+            result += "\n"
+        
+        return result
+        
+    except SiteBayError as e:
+        return f"Error listing external paths for {fqdn}: {str(e)}"
+
+
+async def sitebay_site_external_path_create(
+    client: SiteBayClient,
+    fqdn: str,
+    path: str,
+    target_url: str,
+    description: Optional[str] = None
+) -> str:
+    """
+    Create an external path configuration for a site.
+    
+    Args:
+        fqdn: The fully qualified domain name of the site
+        path: The path on your site (e.g., "/api")
+        target_url: The external URL to proxy to
+        description: Optional description for the path
+    
+    Returns:
+        Success message with path details
+    """
+    try:
+        path_data = {
+            "path": path,
+            "target_url": target_url,
+        }
+        
+        if description:
+            path_data["description"] = description
+        
+        external_path = await client.create_external_path(fqdn, path_data)
+        
+        result = f"✅ **External Path Created Successfully**\n\n"
+        result += f"• **Site**: {fqdn}\n"
+        result += f"• **Path**: {external_path.get('path')}\n"
+        result += f"• **Target URL**: {external_path.get('target_url')}\n"
+        result += f"• **Status**: {external_path.get('status')}\n"
+        result += f"• **ID**: {external_path.get('id')}\n"
+        
+        if description:
+            result += f"• **Description**: {description}\n"
+        
+        result += f"\n🔗 Your site path {fqdn}{path} now proxies to {target_url}"
+        
+        return result
+        
+    except SiteBayError as e:
+        return f"Error creating external path for {fqdn}: {str(e)}"
+
+
+async def sitebay_site_external_path_update(
+    client: SiteBayClient,
+    fqdn: str,
+    path_id: str,
+    path: Optional[str] = None,
+    target_url: Optional[str] = None,
+    description: Optional[str] = None
+) -> str:
+    """
+    Update an external path configuration.
+    
+    Args:
+        fqdn: The fully qualified domain name of the site
+        path_id: The ID of the external path to update
+        path: New path value (optional)
+        target_url: New target URL (optional)
+        description: New description (optional)
+    
+    Returns:
+        Update confirmation message
+    """
+    try:
+        path_data = {}
+        
+        if path:
+            path_data["path"] = path
+        if target_url:
+            path_data["target_url"] = target_url
+        if description:
+            path_data["description"] = description
+        
+        if not path_data:
+            return "No updates specified. Please provide at least one field to update."
+        
+        external_path = await client.update_external_path(fqdn, path_id, path_data)
+        
+        result = f"✅ **External Path Updated Successfully**\n\n"
+        result += f"• **Site**: {fqdn}\n"
+        result += f"• **Path**: {external_path.get('path')}\n"
+        result += f"• **Target URL**: {external_path.get('target_url')}\n"
+        result += f"• **Status**: {external_path.get('status')}\n"
+        result += f"• **ID**: {external_path.get('id')}\n"
+        
+        return result
+        
+    except SiteBayError as e:
+        return f"Error updating external path for {fqdn}: {str(e)}"
+
+
+async def sitebay_site_external_path_delete(
+    client: SiteBayClient,
+    fqdn: str,
+    path_id: str
+) -> str:
+    """
+    Delete an external path configuration.
+    
+    Args:
+        fqdn: The fully qualified domain name of the site
+        path_id: The ID of the external path to delete
+    
+    Returns:
+        Deletion confirmation message
+    """
+    try:
+        await client.delete_external_path(fqdn, path_id)
+        
+        return f"✅ **External Path Deleted Successfully**\n\nExternal path {path_id} has been removed from {fqdn}."
+        
+    except SiteBayError as e:
+        return f"Error deleting external path for {fqdn}: {str(e)}"

sitebay_mcp/tools/sites.py

@@ -0,0 +1,248 @@
+"""
+Site management tools for SiteBay MCP Server
+"""
+
+from typing import Optional, Dict, Any, List
+from ..client import SiteBayClient
+from ..exceptions import SiteBayError
+
+
+async def sitebay_list_sites(
+    client: SiteBayClient,
+    team_id: Optional[str] = None
+) -> str:
+    """
+    List all WordPress sites for the authenticated user.
+    
+    Args:
+        team_id: Optional team ID to filter sites by team
+    
+    Returns:
+        Formatted string with site details
+    """
+    try:
+        sites = await client.list_sites(team_id=team_id)
+        
+        if not sites:
+            return "No sites found for your account."
+        
+        result = f"Found {len(sites)} site(s):\n\n"
+        
+        for site in sites:
+            result += f"• **{site.get('fqdn', 'Unknown')}**\n"
+            result += f"  - Status: {site.get('status', 'Unknown')}\n"
+            result += f"  - Region: {site.get('region_name', 'Unknown')}\n"
+            result += f"  - WordPress Version: {site.get('wp_version', 'Unknown')}\n"
+            result += f"  - PHP Version: {site.get('php_version', 'Unknown')}\n"
+            result += f"  - Created: {site.get('created_at', 'Unknown')}\n"
+            if site.get('staging_site'):
+                result += f"  - Has Staging Site: Yes\n"
+            result += "\n"
+        
+        return result
+        
+    except SiteBayError as e:
+        return f"Error listing sites: {str(e)}"
+
+
+async def sitebay_get_site(
+    client: SiteBayClient,
+    fqdn: str
+) -> str:
+    """
+    Get detailed information about a specific WordPress site.
+    
+    Args:
+        fqdn: The fully qualified domain name of the site
+    
+    Returns:
+        Formatted string with detailed site information
+    """
+    try:
+        site = await client.get_site(fqdn)
+        
+        result = f"**Site Details for {fqdn}**\n\n"
+        result += f"• **Status**: {site.get('status', 'Unknown')}\n"
+        result += f"• **Region**: {site.get('region_name', 'Unknown')}\n"
+        result += f"• **WordPress Version**: {site.get('wp_version', 'Unknown')}\n"
+        result += f"• **PHP Version**: {site.get('php_version', 'Unknown')}\n"
+        result += f"• **MySQL Version**: {site.get('mysql_version', 'Unknown')}\n"
+        result += f"• **Site URL**: {site.get('site_url', 'Unknown')}\n"
+        result += f"• **Admin URL**: {site.get('admin_url', 'Unknown')}\n"
+        result += f"• **Created**: {site.get('created_at', 'Unknown')}\n"
+        result += f"• **Updated**: {site.get('updated_at', 'Unknown')}\n"
+        
+        if site.get('staging_site'):
+            result += f"• **Staging Site**: Available\n"
+        else:
+            result += f"• **Staging Site**: Not created\n"
+        
+        if site.get('git_enabled'):
+            result += f"• **Git Integration**: Enabled\n"
+            if site.get('git_repo'):
+                result += f"• **Git Repository**: {site.get('git_repo')}\n"
+        
+        return result
+        
+    except SiteBayError as e:
+        return f"Error getting site details: {str(e)}"
+
+
+async def sitebay_create_site(
+    client: SiteBayClient,
+    fqdn: str,
+    wp_title: str,
+    wp_username: str,
+    wp_password: str,
+    wp_email: str,
+    region_name: Optional[str] = None,
+    template_id: Optional[str] = None,
+    team_id: Optional[str] = None
+) -> str:
+    """
+    Create a new WordPress site.
+    
+    Args:
+        fqdn: The fully qualified domain name for the new site
+        wp_title: WordPress site title
+        wp_username: WordPress admin username
+        wp_password: WordPress admin password
+        wp_email: WordPress admin email
+        region_name: Optional region name (uses default if not specified)
+        template_id: Optional template ID to use for site creation
+        team_id: Optional team ID to create site under
+    
+    Returns:
+        Formatted string with new site details
+    """
+    try:
+        site_data = {
+            "fqdn": fqdn,
+            "wp_title": wp_title,
+            "wp_username": wp_username,
+            "wp_password": wp_password,
+            "wp_email": wp_email,
+        }
+        
+        if region_name:
+            site_data["region_name"] = region_name
+        if template_id:
+            site_data["template_id"] = template_id
+        if team_id:
+            site_data["team_id"] = team_id
+        
+        site = await client.create_site(site_data)
+        
+        result = f"✅ **Site Created Successfully!**\n\n"
+        result += f"• **Domain**: {site.get('fqdn')}\n"
+        result += f"• **Status**: {site.get('status')}\n"
+        result += f"• **Region**: {site.get('region_name')}\n"
+        result += f"• **Site URL**: {site.get('site_url')}\n"
+        result += f"• **Admin URL**: {site.get('admin_url')}\n"
+        result += f"• **WordPress Admin**: {wp_username}\n"
+        result += f"• **WordPress Email**: {wp_email}\n"
+        result += f"\n🚀 Your WordPress site is being deployed and will be ready shortly!"
+        
+        return result
+        
+    except SiteBayError as e:
+        return f"Error creating site: {str(e)}"
+
+
+async def sitebay_update_site(
+    client: SiteBayClient,
+    fqdn: str,
+    wp_title: Optional[str] = None,
+    wp_username: Optional[str] = None,
+    wp_password: Optional[str] = None,
+    wp_email: Optional[str] = None,
+    php_version: Optional[str] = None
+) -> str:
+    """
+    Update an existing WordPress site configuration.
+    
+    Args:
+        fqdn: The fully qualified domain name of the site to update
+        wp_title: New WordPress site title
+        wp_username: New WordPress admin username
+        wp_password: New WordPress admin password
+        wp_email: New WordPress admin email
+        php_version: New PHP version (e.g., "8.1", "8.2")
+    
+    Returns:
+        Formatted string with update confirmation
+    """
+    try:
+        site_data = {}
+        
+        if wp_title:
+            site_data["wp_title"] = wp_title
+        if wp_username:
+            site_data["wp_username"] = wp_username
+        if wp_password:
+            site_data["wp_password"] = wp_password
+        if wp_email:
+            site_data["wp_email"] = wp_email
+        if php_version:
+            site_data["php_version"] = php_version
+        
+        if not site_data:
+            return "No updates specified. Please provide at least one field to update."
+        
+        site = await client.update_site(fqdn, site_data)
+        
+        result = f"✅ **Site Updated Successfully!**\n\n"
+        result += f"• **Domain**: {site.get('fqdn')}\n"
+        result += f"• **Status**: {site.get('status')}\n"
+        
+        if wp_title:
+            result += f"• **Title**: Updated to '{wp_title}'\n"
+        if wp_username:
+            result += f"• **Admin Username**: Updated to '{wp_username}'\n"
+        if wp_password:
+            result += f"• **Admin Password**: Updated\n"
+        if wp_email:
+            result += f"• **Admin Email**: Updated to '{wp_email}'\n"
+        if php_version:
+            result += f"• **PHP Version**: Updated to {php_version}\n"
+        
+        return result
+        
+    except SiteBayError as e:
+        return f"Error updating site: {str(e)}"
+
+
+async def sitebay_delete_site(
+    client: SiteBayClient,
+    fqdn: str,
+    confirm: bool = False
+) -> str:
+    """
+    Delete a WordPress site permanently.
+    
+    Args:
+        fqdn: The fully qualified domain name of the site to delete
+        confirm: Must be True to actually delete the site (safety check)
+    
+    Returns:
+        Confirmation message or error
+    """
+    if not confirm:
+        return (
+            f"⚠️  **CONFIRMATION REQUIRED**\n\n"
+            f"You are about to permanently delete the site: **{fqdn}**\n\n"
+            f"This action will:\n"
+            f"• Delete all website files and content\n"
+            f"• Delete the database and all data\n"
+            f"• Remove any staging sites\n"
+            f"• Cannot be undone\n\n"
+            f"To proceed with deletion, call this function again with confirm=True"
+        )
+    
+    try:
+        await client.delete_site(fqdn)
+        
+        return f"✅ **Site Deleted Successfully**\n\nThe site {fqdn} has been permanently deleted."
+        
+    except SiteBayError as e:
+        return f"Error deleting site: {str(e)}"