[](https://github.com/mock-server/mockserver-monorepo/stargazers)
May 11, 2026 · View on GitHub
MockServer 
Quick Start
Run MockServer with Docker in seconds:
docker run -d --rm -p 1080:1080 mockserver/mockserver
For more configuration options see the Docker documentation.
Documentation
For usage guide please see: www.mock-server.com
Developer Documentation
Architecture, code structure, infrastructure, and operations documentation is available in the docs/ directory.
AI Integration
MockServer includes a built-in MCP server for AI coding assistant integration at /mockserver/mcp. See llms.txt and AI Integration docs.
Change Log
Please see: Change Log
Community
| Discussions |  |
| Feature Requests | |
| Issues / Bugs | |
| Roadmap | |
| Security | |
Requirements
MockServer requires Java 11+. Java 11 is the minimum supported version to maximise compatibility — approximately 23% of Java projects still run on Java 11.
Security Note: MockServer is a development and testing tool only. See SECURITY.md for important security considerations.
Versions
Maven Central 
Maven Central contains the following MockServer artifacts:
- mockserver-netty-no-dependencies - an HTTP(S) web server that mocks and records requests and responses, with all dependencies bundled and relocated — zero transitive dependencies (recommended)
- mockserver-netty - as above but with transitive dependencies declared in the POM
- mockserver-war - a deployable WAR for mocking HTTP(S) responses (for any JEE web server)
- mockserver-proxy-war - a deployable WAR that records requests and responses (for any JEE web server)
- mockserver-maven-plugin - a maven plugin to start, stop and fork MockServer using maven
- mockserver-client-java-no-dependencies - a Java client to communicate with both the server and the proxy, with all dependencies bundled and relocated — zero transitive dependencies (recommended)
- mockserver-client-java - as above but with transitive dependencies declared in the POM
Tip: The
-no-dependenciesartifacts bundle all dependencies into a single JAR with relocated packages, so they declare zero transitive dependencies. This avoids classpath conflicts and eliminates CVE scanning noise from unused transitive dependencies. See the Maven Central page for all artifact variants.
In addition MockServer SNAPSHOT artifacts can also be found on Sonatype.
Node Module & Grunt Plugin
NPM Registry contains the following module:
- mockserver-node - a Node.js module and Grunt plugin to start and stop MockServer
- mockserver-client-node - a Node.js client for both the MockServer and the proxy
Docker Hub
Docker Hub contains the following artifacts:
- MockServer Docker Container - a Docker container containing the Netty MockServer and proxy
Helm Chart
- MockServer Helm Chart - a Helm Chart that installs MockServer to a Kubernetes cluster (latest: 5.15.0). See the Install MockServer Helm Chart guide for all available versions and configuration options.
MockServer Clients
- mockserver-client-java
- a Java client for both the MockServer and the proxy (use the -no-dependenciesartifact to avoid transitive dependencies) - mockserver-client-node
- a Node.js and browser client for both the MockServer and the proxy - mockserver-client-python - a Python client for both the MockServer and the proxy
- mockserver-client-ruby
- a Ruby client for both the MockServer and the proxy
Community Tools
- MockServer Browser Admin - a React + TypeScript SPA for managing MockServer expectations via a web UI
Previous Versions
Issues
If you have any problems, please check the project issues and avoid opening issues that have already been fixed. When you open an issue please provide the following information:
- MockServer version (i.e. 5.15.0)
- How your running the MockServer (i.e maven plugin, docker, etc)
- MockServer log output, at INFO level (or higher)
- What the error is
- What you are trying to do
Contributions
Pull requests are, of course, very welcome! Please read our contributing to the project guide first. Then head over to the open issues to see what we need help with. Make sure you let us know if you intend to work on something. Also check out the project roadmap to see what is already in the backlog.
Feature Requests
Feature requests are submitted to GitHub issues and tracked on the project roadmap.