Release Notes for MockLoop MCP v2.2.9

Release Date: June 2, 2025

🚀 Major Features

Full Feature Parity Between SSE and Stdio Transports

• Complete Transport Unification: Implemented full feature parity between SSE (Server-Sent Events) and stdio transport modes
• New Stdio Server: Added dedicated stdio_server.py with complete MCP tool and resource support
• Automatic Mode Detection: Enhanced main.py with intelligent transport mode detection
• Claude Desktop Compatibility: Seamless integration with Claude Desktop and other MCP clients using stdio transport

🔧 Enhanced MCP Integration

Stdio Transport Implementation

• All 30 MCP Tools: Complete tool availability in stdio mode (16 testing + 10 context + 4 core tools)
• 5 AI Prompts: Full AI-driven scenario generation capabilities in stdio mode
• 15 Scenario Resources: Complete community scenario pack access
• Context Management: Full stateful workflow support with GlobalContext and AgentContext

Transport Mode Detection

• Automatic Detection: Intelligent detection of stdin piping for MCP client communication
• Flag Support: Explicit --stdio flag for forced stdio mode operation
• Backward Compatibility: Maintained existing --sse and --cli mode functionality
• Seamless Switching: Zero-configuration mode switching based on execution context

🛠️ Technical Improvements

Code Architecture

• Modular Design: Separated stdio server implementation for better maintainability
• Import Handling: Robust import resolution for different execution contexts
• Error Handling: Enhanced error handling for transport mode failures
• Performance: Optimized stdio communication for better responsiveness

MCP Client Support

• Claude Desktop: Native support for Claude Desktop MCP configuration
• Cline Extension: Enhanced VS Code Cline extension compatibility
• Generic MCP Clients: Universal support for any MCP-compatible client
• Transport Negotiation: Automatic transport protocol selection

📋 Configuration Updates

MCP Client Configuration Examples

// Claude Desktop - Simplified Configuration
{
  "mcpServers": {
    "mockloop": {
      "command": "mockloop-mcp",
      "args": []
    }
  }
}

// Cline - Enhanced Stdio Support
{
  "mcpServers": {
    "MockLoopLocal": {
      "command": "mockloop-mcp",
      "args": [],
      "transportType": "stdio"
    }
  }
}

🔄 Migration Guide

For Existing Users

• No Breaking Changes: All existing configurations continue to work
• Automatic Upgrade: Stdio mode automatically detected when appropriate
• Manual Override: Use --stdio flag for explicit stdio mode activation
• SSE Mode: Existing --sse configurations remain unchanged

For New Installations

• Default Behavior: Automatic mode detection based on execution context
• MCP Clients: Stdio mode automatically used when launched by MCP clients
• CLI Usage: Traditional CLI mode for direct command-line usage
• Server Mode: SSE mode for web-based integrations

🧪 Testing Enhancements

Integration Tests

• Transport Testing: Comprehensive tests for both stdio and SSE modes
• Feature Parity: Validation of identical functionality across transports
• MCP Compliance: Enhanced MCP protocol compliance testing
• Performance Testing: Transport-specific performance benchmarks

📚 Documentation Updates

Updated Guides

• Installation Guide: Enhanced MCP client configuration examples
• Quick Start: Simplified setup process for different transport modes
• Integration Examples: Updated examples for stdio transport usage
• Troubleshooting: Transport-specific troubleshooting guidance

🔒 Security & Stability

Enhanced Security

• Transport Security: Secure stdio communication protocols
• Input Validation: Enhanced validation for stdio message handling
• Error Isolation: Improved error isolation between transport modes
• Resource Protection: Secure resource access across transport types

🎯 Use Cases Enabled

Development Workflows

• IDE Integration: Seamless integration with VS Code, Claude Desktop, and other IDEs
• AI-Assisted Development: Enhanced AI-driven testing workflows
• Cross-Platform: Consistent behavior across different operating systems
• Team Collaboration: Standardized MCP integration for development teams

Enterprise Integration

• CI/CD Pipelines: Enhanced automation capabilities with stdio transport
• Monitoring Systems: Better integration with enterprise monitoring tools
• Compliance: Improved audit logging across all transport modes
• Scalability: Enhanced performance for high-volume testing scenarios

🚀 Performance Improvements

Transport Optimization

• Stdio Performance: Optimized stdio message handling and processing
• Memory Usage: Reduced memory footprint for stdio operations
• Response Times: Improved response times for MCP tool execution
• Concurrent Operations: Enhanced support for concurrent MCP operations

Added

• Comprehensive MCP Proxy functionality enabling mock, proxy, and hybrid modes for API testing.
  • Includes core proxy handling: ProxyHandler, configuration: ProxyConfig, AuthConfig, RouteRule, authentication management: AuthHandler, and plugin management: PluginManager.
  • Integrated proxy capabilities into MCP tools: create_mcp_plugin() and execute_test_plan().
• Detailed documentation guide for MCP Proxy: docs/mcp-proxy-guide.md.
• New example scripts in examples/mcp-proxy/ demonstrating:
  • Plugin creation in proxy and hybrid modes: create_plugin_modes_example.py.
  • Executing test plans with a proxy mode plugin: execute_plan_with_proxy_example.py.
  • Configuring hybrid mode with routing rules: hybrid_mode_routing_example.py.
• New end-to-end integration tests for MCP Proxy: tests/integration/test_mcp_proxy_integration.py, covering proxy and hybrid mode configurations and execution.

Changed

• Updated README.md to include a new section detailing the MCP Proxy functionality and linking to the guide.
• Refined existing example basic-mock-example.py to serve as the primary mock mode example and updated its "Next Steps" to reference new, more specific proxy examples.
• Modified create_plugin_modes_example.py to focus solely on proxy and hybrid modes, deferring mock mode to basic-mock-example.py.

Added

• Added --stdio support for Claude Code integration
• Dual-mode MCP server supporting both stdio and SSE communication
• Backward compatibility with existing SSE-based MCP clients

Changed

• Enhanced server startup logic to detect communication mode via command-line flags
• Maintained existing --cli and default SSE functionality