Utilizes aiohttp for asynchronous HTTP operations in the mock server management and log analysis features
Generates Docker configurations (Dockerfile and docker-compose.yml) to containerize and run the mock API servers
Generates mock API servers using FastAPI as the framework, complete with middleware, admin UI, and logging capabilities
Planned future support for generating mock API servers from GraphQL SDL specifications
Uses Jinja templating to generate server code and admin UI components for the mock API servers
Planned future support for generating mock API servers from Postman Collections
Implements SQLite-based storage for comprehensive request/response logging with advanced querying capabilities
Takes OpenAPI/Swagger specifications as input to generate functional mock API servers that simulate the defined endpoints
Supports parsing OpenAPI specifications in YAML format to generate mock API servers
MockLoop MCP - AI-Native Testing Platform
The world's first AI-native API testing platform powered by the Model Context Protocol (MCP). MockLoop MCP revolutionizes API testing with comprehensive AI-driven scenario generation, automated test execution, and intelligent analysis capabilities.
🚀 Revolutionary Capabilities: 5 AI Prompts • 15 Scenario Resources • 16 Testing Tools • 10 Context Tools • 4 Core Tools • Complete MCP Integration
📚 Documentation: https://docs.mockloop.com
📦 PyPI Package: https://pypi.org/project/mockloop-mcp/
🐙 GitHub Repository: https://github.com/mockloop/mockloop-mcp
🌟 What Makes MockLoop MCP Revolutionary?
MockLoop MCP represents a paradigm shift in API testing, introducing the world's first AI-native testing architecture that combines:
- 🤖 AI-Driven Test Generation: 5 specialized MCP prompts for intelligent scenario creation
- 📦 Community Scenario Packs: 15 curated testing resources with community architecture
- ⚡ Automated Test Execution: 30 comprehensive MCP tools for complete testing workflows (16 testing + 10 context + 4 core)
- 🔄 Stateful Testing: Advanced context management with GlobalContext and AgentContext
- 📊 Enterprise Compliance: Complete audit logging and regulatory compliance tracking
- 🏗️ Dual-Port Architecture: Eliminates /admin path conflicts with separate business and admin ports
🎯 Core AI-Native Architecture
MCP Audit Logging
Enterprise-grade compliance and regulatory tracking
- Complete request/response audit trails
- Regulatory compliance monitoring
- Performance metrics and analytics
- Security event logging
MCP Prompts (5 AI-Driven Capabilities)
Intelligent scenario generation powered by AI
analyze_openapi_for_testing
- Comprehensive API analysis for testing strategiesgenerate_scenario_config
- Dynamic test scenario configurationoptimize_scenario_for_load
- Load testing optimizationgenerate_error_scenarios
- Error condition simulationgenerate_security_test_scenarios
- Security vulnerability testing
MCP Resources (15 Scenario Packs)
Community-driven testing scenarios with advanced architecture
- Load Testing Scenarios: High-volume traffic simulation
- Error Simulation Packs: Comprehensive error condition testing
- Security Testing Suites: Vulnerability assessment scenarios
- Performance Benchmarks: Standardized performance testing
- Integration Test Packs: Cross-service testing scenarios
- Community Architecture: Collaborative scenario sharing and validation
MCP Tools (16 Automated Testing Tools)
Complete automated test execution capabilities
Scenario Management (4 tools)
validate_scenario_config
- Scenario validation and verificationdeploy_scenario
- Automated scenario deploymentswitch_scenario
- Dynamic scenario switchinglist_active_scenarios
- Active scenario monitoring
Test Execution (4 tools)
execute_test_plan
- Comprehensive test plan executionrun_test_iteration
- Individual test iteration managementrun_load_test
- Load testing executionrun_security_test
- Security testing automation
Analysis & Reporting (4 tools)
analyze_test_results
- Intelligent test result analysisgenerate_test_report
- Comprehensive reportingcompare_test_runs
- Test run comparison and trendsget_performance_metrics
- Performance metrics collection
Workflow Management (4 tools)
create_test_session
- Test session initializationend_test_session
- Session cleanup and finalizationschedule_test_suite
- Automated test schedulingmonitor_test_progress
- Real-time progress monitoring
MCP Context Management (10 Stateful Workflow Tools)
Advanced state management for complex testing workflows
Context Creation & Management
create_test_session_context
- Test session state managementcreate_workflow_context
- Complex workflow orchestrationcreate_agent_context
- AI agent state management
Data Management
get_context_data
- Context data retrievalupdate_context_data
- Dynamic context updateslist_contexts_by_type
- Context discovery and listing
Snapshot & Recovery
create_context_snapshot
- State snapshot creationrestore_context_snapshot
- State rollback capabilities
Global Context
get_global_context_data
- Cross-session data sharingupdate_global_context_data
- Global state management
🚀 Quick Start
Get started with the world's most advanced AI-native testing platform:
📋 Prerequisites
- Python 3.10+
- Pip package manager
- Docker and Docker Compose (for containerized mock servers)
- An MCP-compatible client (Cline, Claude Desktop, etc.)
🔧 Installation
Option 1: Install from PyPI (Recommended)
Option 2: Development Installation
⚙️ Configuration
MCP Client Configuration
Cline (VS Code Extension)
Add to your Cline MCP settings file:
Claude Desktop
Add to your Claude Desktop configuration:
Virtual Environment Installations
For virtual environment installations, use the full Python path:
🛠️ Available MCP Tools
Core Mock Generation
generate_mock_api
Generate sophisticated FastAPI mock servers with dual-port architecture.
Parameters:
spec_url_or_path
(string, required): API specification URL or local file pathoutput_dir_name
(string, optional): Output directory nameauth_enabled
(boolean, optional): Enable authentication middleware (default: true)webhooks_enabled
(boolean, optional): Enable webhook support (default: true)admin_ui_enabled
(boolean, optional): Enable admin UI (default: true)storage_enabled
(boolean, optional): Enable storage functionality (default: true)
Revolutionary Dual-Port Architecture:
- Business API Port: Serves your API endpoints (default: 8000)
- Admin UI Port: Separate admin interface (default: 8001)
- Conflict Resolution: Eliminates /admin path conflicts in OpenAPI specs
- Enhanced Security: Port-based access control and isolation
Advanced Analytics
query_mock_logs
Query and analyze request logs with AI-powered insights.
Parameters:
server_url
(string, required): Mock server URLlimit
(integer, optional): Maximum logs to return (default: 100)offset
(integer, optional): Pagination offset (default: 0)method
(string, optional): Filter by HTTP methodpath_pattern
(string, optional): Regex pattern for path filteringtime_from
(string, optional): Start time filter (ISO format)time_to
(string, optional): End time filter (ISO format)include_admin
(boolean, optional): Include admin requests (default: false)analyze
(boolean, optional): Perform AI analysis (default: true)
AI-Powered Analysis:
- Performance metrics (P95/P99 response times)
- Error rate analysis and categorization
- Traffic pattern detection
- Automated debugging recommendations
- Session correlation and tracking
discover_mock_servers
Intelligent server discovery with dual-port architecture support.
Parameters:
ports
(array, optional): Ports to scan (default: common ports)check_health
(boolean, optional): Perform health checks (default: true)include_generated
(boolean, optional): Include generated mocks (default: true)
Advanced Discovery:
- Automatic architecture detection (single-port vs dual-port)
- Health status monitoring
- Server correlation and matching
- Port usage analysis
manage_mock_data
Dynamic response management without server restart.
Parameters:
server_url
(string, required): Mock server URLoperation
(string, required): Operation type ("update_response", "create_scenario", "switch_scenario", "list_scenarios")endpoint_path
(string, optional): API endpoint pathresponse_data
(object, optional): New response datascenario_name
(string, optional): Scenario namescenario_config
(object, optional): Scenario configuration
Dynamic Capabilities:
- Real-time response updates
- Scenario-based testing
- Runtime configuration management
- Zero-downtime modifications
🤖 AI Framework Integration
MockLoop MCP provides native integration with popular AI frameworks:
LangGraph Integration
CrewAI Multi-Agent Testing
LangChain AI Testing Tools
🏗️ Dual-Port Architecture
MockLoop MCP introduces a revolutionary dual-port architecture that eliminates common conflicts and enhances security:
Architecture Benefits
- 🔒 Enhanced Security: Complete separation of business and admin functionality
- ⚡ Zero Conflicts: Eliminates /admin path conflicts in OpenAPI specifications
- 📊 Clean Analytics: Admin calls don't appear in business API metrics
- 🔄 Independent Scaling: Scale business and admin services separately
- 🛡️ Port-Based Access Control: Enhanced security through network isolation
Port Configuration
Access Points
- Business API:
http://localhost:8000
- Your API endpoints - Admin UI:
http://localhost:8001
- Management interface - API Documentation:
http://localhost:8000/docs
- Interactive Swagger UI - Health Check:
http://localhost:8000/health
- Server status
📊 Enterprise Features
Compliance & Audit Logging
MockLoop MCP provides enterprise-grade compliance features:
- Complete Audit Trails: Every request/response logged with metadata
- Regulatory Compliance: GDPR, SOX, HIPAA compliance support
- Performance Metrics: P95/P99 response times, error rates
- Security Monitoring: Threat detection and analysis
- Session Tracking: Cross-request correlation and analysis
Advanced Analytics
- AI-Powered Insights: Intelligent analysis and recommendations
- Traffic Pattern Detection: Automated anomaly detection
- Performance Optimization: AI-driven performance recommendations
- Error Analysis: Intelligent error categorization and resolution
- Trend Analysis: Historical performance and usage trends
🔄 Stateful Testing Workflows
MockLoop MCP supports complex, stateful testing workflows through advanced context management:
Context Types
- Test Session Context: Maintain state across test executions
- Workflow Context: Complex multi-step testing orchestration
- Agent Context: AI agent state management and coordination
- Global Context: Cross-session data sharing and persistence
Example: Stateful E-commerce Testing
🚀 Running Generated Mock Servers
Using Docker Compose (Recommended)
Using Uvicorn Directly
Enhanced Features Access
- Admin UI:
http://localhost:8001
- Enhanced management interface - API Documentation:
http://localhost:8000/docs
- Interactive Swagger UI - Health Check:
http://localhost:8000/health
- Server status and metrics - Log Analytics:
http://localhost:8001/api/logs/search
- Advanced log querying - Performance Metrics:
http://localhost:8001/api/logs/analyze
- AI-powered insights - Scenario Management:
http://localhost:8001/api/mock-data/scenarios
- Dynamic testing
📈 Performance & Scalability
MockLoop MCP is designed for enterprise-scale performance:
Performance Metrics
- Response Times: P50, P95, P99 percentile tracking
- Throughput: Requests per second monitoring
- Error Rates: Comprehensive error analysis
- Resource Usage: Memory, CPU, and network monitoring
- Concurrency: Multi-user load testing support
Scalability Features
- Horizontal Scaling: Multi-instance deployment support
- Load Balancing: Built-in load balancing capabilities
- Caching: Intelligent response caching
- Database Optimization: Efficient SQLite and PostgreSQL support
- Container Orchestration: Kubernetes and Docker Swarm ready
🔒 Security Features
Built-in Security
- Authentication Middleware: Configurable auth mechanisms
- Rate Limiting: Prevent abuse and DoS attacks
- Input Validation: Comprehensive request validation
- Security Headers: CORS, CSP, and security headers
- Audit Logging: Complete security event logging
Security Testing
- Vulnerability Assessment: AI-powered security testing
- Penetration Testing: Automated security scenario generation
- Compliance Checking: Security standard compliance verification
- Threat Modeling: AI-driven threat analysis
- Security Reporting: Comprehensive security analytics
🛣️ Roadmap & Future Development
Completed Phases ✅
- Phase 1: MCP Audit Logging - Enterprise compliance tracking
- Phase 2: MCP Prompts - AI-driven scenario generation
- Phase 3: MCP Resources - Community scenario packs
- Phase 4: MCP Tools - Automated test execution
- Phase 5: MCP Context Management - Stateful workflows
Upcoming Features 🚧
Enhanced AI Capabilities
- Advanced ML Models: Custom model training for API testing
- Predictive Analytics: AI-powered failure prediction
- Intelligent Test Generation: Self-improving test scenarios
- Natural Language Testing: Plain English test descriptions
Extended Protocol Support
- GraphQL Support: Native GraphQL API testing
- gRPC Integration: Protocol buffer testing support
- WebSocket Testing: Real-time communication testing
- Event-Driven Testing: Async and event-based API testing
Enterprise Integration
- CI/CD Integration: Native pipeline integration
- Monitoring Platforms: Datadog, New Relic, Prometheus integration
- Identity Providers: SSO and enterprise auth integration
- Compliance Frameworks: Extended regulatory compliance support
🤝 Contributing
We welcome contributions to MockLoop MCP! Please see our Contributing Guidelines for details.
Development Setup
Community
- GitHub Repository: mockloop/mockloop-mcp
- Issues & Bug Reports: GitHub Issues
- Feature Requests: GitHub Issues
- Documentation: docs.mockloop.com
📄 License
MockLoop MCP is licensed under the MIT License.
🎉 Get Started Today!
Ready to revolutionize your API testing with the world's first AI-native testing platform?
Join the AI-native testing revolution and experience the future of API testing with MockLoop MCP!
🚀 Get Started Now →
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol server that generates and runs mock API servers from API documentation like OpenAPI/Swagger specs, enabling developers and AI assistants to quickly spin up mock backends for development and testing.
- 🌟 What Makes MockLoop MCP Revolutionary?
- 🎯 Core AI-Native Architecture
- 🚀 Quick Start
- 📋 Prerequisites
- 🔧 Installation
- ⚙️ Configuration
- 🛠️ Available MCP Tools
- 🤖 AI Framework Integration
- 🏗️ Dual-Port Architecture
- 📊 Enterprise Features
- 🔄 Stateful Testing Workflows
- 🚀 Running Generated Mock Servers
- 📈 Performance & Scalability
- 🔒 Security Features
- 🛣️ Roadmap & Future Development
- 🤝 Contributing
- 📄 License
- 🎉 Get Started Today!
Related MCP Servers
- -securityAlicense-qualityAn MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.Last updated -2PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.Last updated -Python
- -securityAlicense-qualityA server that enables interaction with any API that has a Swagger/OpenAPI specification through Model Context Protocol (MCP), automatically generating tools from API endpoints and supporting multiple authentication methods.Last updated -61TypeScriptApache 2.0
- -securityFlicense-qualityA server based on Model Context Protocol that parses Swagger/OpenAPI documents and generates TypeScript types and API client code for different frameworks (Axios, Fetch, React Query).Last updated -1431TypeScript