mock-server/mockserver
Mockserver
Mockserver is a multi-protocol mock server and API verification proxy used to simulate HTTP, gRPC, and WebSocket endpoints. It functions as a tool for testing client applications without relying on live backend services, providing a system to simulate chat completions and streaming responses for large language model integrations.
The project automates behavior by generating request expectations and response behaviors from OpenAPI and Swagger specification files. It differentiates itself through a network traffic simulator that introduces latency, dropped connections, and failures to verify how applications handle unstable network dependencies.
The platform covers API contract testing and request pattern verification, using a matching engine to map incoming requests to predefined responses. It also includes capabilities for live traffic monitoring, recording, and modification to analyze data flow or replay traffic for debugging.
Features
- API Mocking - Provides a multi-protocol mock server to simulate HTTP, gRPC, and WebSocket endpoints for client testing.
- OpenAPI Mock Generators - Automatically generates mock API responses and expectations from OpenAPI or Swagger specification files.
- AI and LLM Testing - Simulates AI chat completions and streaming responses to test LLM workflows without external providers.
- API Interception Proxies - Intercepts and records live network traffic to verify request patterns and assert correct API call sequences.
- Request Matching Engines - Maps incoming network requests to predefined responses using metadata, body content, or header patterns.
- API Response Simulators - Matches incoming requests on metadata or bodies to return configured responses across multiple protocols.
- LLM Response Simulators - Provides a mocking interface for testing LLM integrations by simulating chat completion and streaming responses.
- Multi-Protocol Proxies - Provides a proxy layer that handles communication across HTTP, gRPC, and WebSockets.
- API Behavior Definitions - Allows defining expected requests and corresponding responses for HTTP, gRPC, and WebSocket APIs.
- LLM Behavior Simulators - Simulates chat completion interfaces and streaming responses to test large language model integrations.
- HTTP Mock Servers - Simulates HTTP, gRPC, and WebSocket endpoints to test client applications without relying on live backend services.
- Network Failure Simulations - Simulates network-level errors like timeouts and dropped connections to verify application resilience.
- API Contract Validation - Validates that clients correctly implement an OpenAPI specification by simulating expected request/response patterns.
- OpenAPI Specification Imports - Automatically generates request expectations and response behaviors from OpenAPI and Swagger specification files.
- OpenAPI Specification Parsers - Parses OpenAPI specifications to translate them into automated request expectations and responses.
- Real-Time Traffic Dashboards - Provides a real-time web dashboard to visualize incoming HTTP requests and server logs for live inspection.
- Traffic Recorders - Captures and stores live HTTP traffic for subsequent analysis or playback in testing scenarios.
- Network Traffic Analyzers - Intercepts, records, and modifies live API requests and responses to analyze data flow and debug traffic.
- Traffic Interceptors - Captures and alters live network packets between a client and a server to simulate network conditions.
- Traffic Interception and Modification - Intercepts and actively alters live network requests and responses in transit to analyze or modify data.
- Scripted Mock Responses - Generates flexible, dynamic responses using scripts and templates to avoid static values during testing.
- Request Sequence Verification - Asserts that specific requests reached the server in the correct order and with the expected frequency.
- Stateful Request Tracking - Tracks the sequence and frequency of incoming requests to validate the ordering of client-side API calls.
- Response Templating - Produces dynamic content by interpolating variables or executing scripts within response bodies at runtime.
- Mocking Tools - Solution for mocking HTTP/HTTPS services.
