cremote/mcp_cache_test_example.md

MCP Cache and Site Data Management Test Examples

This document provides examples of how to use the new cache and site data management tools through the MCP interface.

Prerequisites

1. Ensure cremotedaemon is running
2. Ensure Chrome/Chromium is running with remote debugging enabled
3. Configure your MCP client to use the cremote MCP server

Example 1: Basic Cache Disable/Enable Workflow

# Navigate to a test page
web_navigate_cremotemcp:
  url: "https://httpbin.org/cache/60"
  screenshot: true

# Disable cache for testing
web_disable_cache_cremotemcp:
  timeout: 10

# Reload page to test without cache
web_navigate_cremotemcp:
  url: "https://httpbin.org/cache/60"

# Re-enable cache
web_enable_cache_cremotemcp:
  timeout: 10

Example 2: Performance Testing Workflow

# Clear cache before performance test
web_clear_cache_cremotemcp:
  timeout: 15

# Disable cache for cold load test
web_disable_cache_cremotemcp:
  timeout: 10

# Navigate and measure performance
web_navigate_cremotemcp:
  url: "https://example.com"
  screenshot: true

# Get performance metrics
web_performance_metrics_cremotemcp: {}

# Enable cache for warm load test
web_enable_cache_cremotemcp:
  timeout: 10

# Navigate again and compare
web_navigate_cremotemcp:
  url: "https://example.com"

# Get performance metrics again
web_performance_metrics_cremotemcp: {}

Example 3: Multi-Tab Cache Management

# Open first tab and disable cache
web_manage_tabs_cremotemcp:
  action: "open"

web_disable_cache_cremotemcp:
  tab: "tab-1"
  timeout: 10

# Open second tab and keep cache enabled
web_manage_tabs_cremotemcp:
  action: "open"

# Navigate both tabs to same URL
web_navigate_cremotemcp:
  url: "https://httpbin.org/cache/60"
  tab: "tab-1"

web_navigate_cremotemcp:
  url: "https://httpbin.org/cache/60"
  tab: "tab-2"

Example 4: Development Workflow

# Disable cache for development
web_disable_cache_cremotemcp:
  timeout: 10

# Navigate to development site
web_navigate_cremotemcp:
  url: "http://localhost:3000"

# Interact with page
web_interact_cremotemcp:
  action: "click"
  selector: "#refresh-button"

# Take screenshot for documentation
web_screenshot_enhanced_cremotemcp:
  output: "/tmp/dev-screenshot.png"
  full_page: true

Error Handling

The cache management tools will return appropriate error messages if:

• The daemon is not running
• Chrome/Chromium is not accessible
• The specified tab doesn't exist
• Network operations timeout

Example error response:

{
  "error": "failed to disable cache: tab not found: tab-123",
  "isError": true
}

Best Practices

1. Always set appropriate timeouts for cache operations (5-15 seconds recommended)
2. Clear cache before performance tests to ensure consistent baseline measurements
3. Disable cache during development to see changes immediately
4. Re-enable cache after testing to restore normal browsing behavior
5. Use specific tab IDs when working with multiple tabs to avoid confusion

Example 5: Authentication Testing Workflow

# Clear all site data before testing login
web_clear_all_site_data_cremotemcp:
  timeout: 15

# Navigate to login page
web_navigate_cremotemcp:
  url: "https://example.com/login"

# Fill login form
web_form_fill_bulk_cremotemcp:
  fields:
    username: "testuser"
    password: "testpass"

# Submit and verify login
web_interact_cremotemcp:
  action: "click"
  selector: "#login-button"

# Clear cookies to test logout behavior
web_clear_cookies_cremotemcp:
  timeout: 10

# Refresh page to verify logout
web_navigate_cremotemcp:
  url: "https://example.com/dashboard"

Example 6: Storage Testing Workflow

# Clear storage before testing
web_clear_storage_cremotemcp:
  timeout: 10

# Navigate to application
web_navigate_cremotemcp:
  url: "https://example.com/app"

# Interact with app to create storage data
web_interact_cremotemcp:
  action: "click"
  selector: "#save-data-button"

# Clear storage to test data persistence
web_clear_storage_cremotemcp:
  timeout: 10

# Refresh to test if data is gone
web_navigate_cremotemcp:
  url: "https://example.com/app"

Integration with Other Tools

Cache and site data management works seamlessly with other cremote MCP tools:

• Use with web_performance_metrics_cremotemcp for performance testing
• Combine with web_navigate_cremotemcp for controlled page loading
• Use with web_screenshot_enhanced_cremotemcp for visual testing
• Integrate with web_interact_cremotemcp for user interaction testing
• Use with web_form_fill_bulk_cremotemcp for authentication testing
• Combine with web_extract_cremotemcp tools for data verification after clearing