Skip to content
Back to search

mockserver-monorepo

MockServer is an HTTP(S) mock server and proxy for testing that lets you mock APIs, inspect and modify live traffic, and inject failures. It supports HTTP/1.1, HTTP/2, gRPC, WebSockets, TCP and more on a single port, with additional support for HTTP/3, message brokers, and AI/LLM APIs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/mock-server/mockserver-monorepo with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/mock-server/mockserver-monorepo'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mock-server--mockserver-monorepo/badge.svg)](/listings/mock-server--mockserver-monorepo)

HTML

<a href="/listings/mock-server--mockserver-monorepo"><img src="/api/listings/mock-server--mockserver-monorepo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Run MockServer with Docker, then mock an endpoint and call it:

# 1. Start MockServer
docker run -d --rm -p 1080:1080 mockserver/mockserver

# 2. Mock an endpoint: GET /hello -> 200 "Hello World"
#    (MockServer exposes a REST control plane on the same port)
curl -X PUT http://localhost:1080/mockserver/expectation \
  -H 'Content-Type: application/json' \
  -d '{
        "httpRequest":  { "method": "GET", "path": "/hello" },
        "httpResponse": { "statusCode": 200, "body": "Hello World" }
      }'

# 3. Call your mock
curl http://localhost:1080/hello
# -> Hello World

…or, on macOS / Linux, install with [Homebrew](https://brew.sh/) and run the `mockserver` command directly:

brew install mockserver
mockserver run --port 1080

For every way to run MockServer — Docker, docker-compose recipes, the `mockserver` CLI, a JVM-less binary bundle, Helm/Kubernetes, the JAR, and Testcontainers — see the [Self-Hosting MockServer guide](https://www.mock-server.com/mock_server/self_hosting_mockserver.html). The same setup can be driven from any client library or the dashboard at <http://localhost:1080/mockserver/dashboard>.

One-command recipes

The [`examples/docker-compose`](examples/docker-compose) recipes are a single `docker compose up` each — mock from an OpenAPI spec, a record/replay proxy, a contract-validating proxy, or a chaos proxy:

cd examples/docker-compose/mock-from-openapi
docker compose up
curl http://localhost:1080/pets

Drive it from Postman or Bruno

- **Postman** — click the button above, or import [`examples/postman`](examples/postman) ([guide](https://www.mock-server.com/where/postman.html)). - **Bruno** (open-source, git-native) — open [`examples/bruno`](examples/bruno) in [Bruno](https://www.usebruno.com/) via **Open Collection** ([guide](https://www.mock-server.com/where/bruno.html)).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 128 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. MockServer &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [![Build status](https://badge.buildkite.com/3b6803f4fe98cb5ed7bf18292a1434f800b53d8fecb92811d8.svg?branch=master&style=square&theme=slack)](https://buildkite.com/mockserver/mockserver)
  2. [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/16733/badge)](https://www.bestpractices.dev/projects/16733)
  3. [![GitHub license](https://img.shields.io/github/license/mock-server/mockserver-monorepo.svg)](https://github.com/mock-server/mockserver-monorepo/blob/master/LICENSE.md)
  4. [![GitHub stars](https://img.shields.io/github/stars/mock-server/mockserver-monorepo.svg)](https://github.com/mock-server/mockserver-monorepo/stargazers)
  5. [![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/mockserver)](https://artifacthub.io/packages/search?repo=mockserver)
  6. [![MCP Toplist](https://mcptoplist.com/badge/com.mock-server%2Fmockserver.svg)](https://mcptoplist.com/server/com.mock-server%2Fmockserver)
  7. =====
  8. **MockServer mocks, records, and chaos-tests any HTTP(S) dependency your application talks to — one binary, no per-protocol setup.**
  9. ## Why MockServer
  10. - **One port, every protocol** — HTTP/1.1, HTTPS, HTTP/2, gRPC & gRPC-Web, WebSockets and raw TCP are auto-detected from the first bytes of each connection. Beyond that: HTTP/3 (QUIC, experimental), JSON-RPC for MCP/A2A mocking, and AsyncAPI-driven testing against Kafka/MQTT brokers.
  11. - **Mock, proxy, or both** — return canned/templated/callback responses, or sit as a proxy (port forwarding, HTTP proxy, HTTPS tunneling, SOCKS) and record, inspect, and modify real traffic in flight, with full visibility into TLS-encrypted exchanges.
  12. - **Chaos engineering built in** — inject latency, dropped connections, and errors on demand to see how your application copes when a dependency misbehaves.
  13. - **Mock AI too** — chat-completion APIs for OpenAI, Anthropic, Gemini, Bedrock, Azure OpenAI and Ollama (including streaming), plus a built-in MCP server so AI coding assistants can drive MockServer directly.
  14. - **Generate mocks, don't hand-write them** — from an OpenAPI/Swagger spec, with request matching on method, path, query, headers, cookies, and body (JSON, XML, JSONPath, XPath, regex).
  15. - **Fits your stack** — Java, JavaScript/Node, Python, Ruby, Go, .NET, Rust, and PHP clients, plus JUnit and Spring support; runs as Docker, Helm/Kubernetes, a JAR, or a WAR, with a live dashboard and optional clustered state for multi-instance deployments.
  16. See the [changelog](changelog.md) for what shipped in each version.
  17. ## Getting started in 60 seconds
  18. Run MockServer with Docker, then mock an endpoint and call it:
  19. ```bash
  20. # 1. Start MockServer
  21. docker run -d --rm -p 1080:1080 mockserver/mockserver
  22. # 2. Mock an endpoint: GET /hello -> 200 "Hello World"
  23. # (MockServer exposes a REST control plane on the same port)
  24. curl -X PUT http://localhost:1080/mockserver/expectation \
  25. -H 'Content-Type: application/json' \
  26. -d '{
  27. "httpRequest": { "method": "GET", "path": "/hello" },
  28. "httpResponse": { "statusCode": 200, "body": "Hello World" }
  29. }'
  30. # 3. Call your mock
  31. curl http://localhost:1080/hello
  32. # -> Hello World
  33. ```
  34. …or, on macOS / Linux, install with [Homebrew](https://brew.sh/) and run the `mockserver` command directly:
  35. ```bash
  36. brew install mockserver
  37. mockserver run --port 1080
  38. ```
  39. For every way to run MockServer — Docker, docker-compose recipes, the `mockserver` CLI, a JVM-less binary bundle, Helm/Kubernetes, the JAR, and Testcontainers — see the [Self-Hosting MockServer guide](https://www.mock-server.com/mock_server/self_hosting_mockserver.html). The same setup can be driven from any client library or the dashboard at <http://localhost:1080/mockserver/dashboard>.
  40. ### One-command recipes
  41. The [`examples/docker-compose`](examples/docker-compose) recipes are a single `docker compose up` each — mock from an OpenAPI spec, a record/replay proxy, a contract-validating proxy, or a chaos proxy:
  42. ```bash
  43. cd examples/docker-compose/mock-from-openapi
  44. docker compose up
  45. curl http://localhost:1080/pets
  46. ```
  47. ### Drive it from Postman or Bruno
  48. [![Run in Postman](https://run.pstmn.io/button.svg)](https://god.gw.postman.com/run-collection/3256712-63a2d67a-46d6-41fd-a544-0535e7393e7d?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D3256712-63a2d67a-46d6-41fd-a544-0535e7393e7d%26entityType%3Dcollection%26workspaceId%3D1739eeee-5da1-4112-86a7-b6c094f2b527)
  49. - **Postman** — click the button above, or import [`examples/postman`](examples/postman) ([guide](https://www.mock-server.com/where/postman.html)).
  50. - **Bruno** (open-source, git-native) — open [`examples/bruno`](examples/bruno) in [Bruno](https://www.usebruno.com/) via **Open Collection** ([guide](https://www.mock-server.com/where/bruno.html)).
  51. ## Install
  52. | Channel | Command |
  53. |---------|---------|
  54. | Docker | `docker run -d --rm -p 1080:1080 mockserver/mockserver` |
  55. | Docker from GitHub Container Registry (avoids Docker Hub's pull limit) | `docker run -d --rm -p 1080:1080 ghcr.io/mock-server/mockserver` |
  56. | Homebrew (macOS/Linux) | `brew install mockserver` |
  57. | Helm ([chart guide](helm/mockserver/README.md)) | `helm upgrade --install --namespace mockserver mockserver oci://ghcr.io/mock-server/charts/mockserver` |
  58. | Maven Central [![mockserver](https://img.shields.io/maven-central/v/org.mock-server/mockserver-netty.svg)](https://central.sonatype.com/search?q=g:org.mock-server) | `org.mock-server:mockserver-netty-no-dependencies` — see [all Maven artifacts](https://www.mock-server.com/where/maven_central.html) (server, WARs, JUnit 4/5, Spring, Maven plugin) |
  59. | npm | [`mockserver-node`](https://www.npmjs.org/package/mockserver-node) (start/stop) |
  60. **Client libraries** (create expectations, verify requests, drive the control plane from your tests):
  61. [![Java](https://img.shields.io/maven-central/v/org.mock-server/mockserver-client-java.svg?label=Java)](https://central.sonatype.com/artifact/org.mock-server/mockserver-client-java)
  62. [![Node](https://img.shields.io/npm/v/mockserver-client.svg?label=Node)](https://www.npmjs.org/package/mockserver-client)
  63. [![PyPI](https://img.shields.io/pypi/v/mockserver-client.svg?label=Python)](https://pypi.org/project/mockserver-client/)
  64. [![Gem](https://badge.fury.io/rb/mockserver-client.png)](https://rubygems.org/gems/mockserver-client)
  65. [![Go](https://pkg.go.dev/badge/github.com/mock-server/mockserver-monorepo/mockserver-client-go/v9.svg)](https://pkg.go.dev/github.com/mock-server/mockserver-monorepo/mockserver-client-go/v9)
  66. [![Packagist](https://img.shields.io/packagist/v/mock-server/mockserver-client.svg?label=PHP)](https://packagist.org/packages/mock-server/mockserver-client)
  67. [![NuGet](https://img.shields.io/nuget/v/MockServerClient.svg?label=.NET)](https://www.nuget.org/packages/MockServerClient)
  68. [![Crates.io](https://img.shields.io/crates/v/mockserver-client.svg?label=Rust)](https://crates.io/crates/mockserver-client)
  69. Full install options (SNAPSHOT repository, WAR deployment, Testcontainers modules, package-manager channels) are on the [Self-Hosting guide](https://www.mock-server.com/mock_server/self_hosting_mockserver.html) and [Where to find MockServer](https://www.mock-server.com/where/maven_central.html).
  70. ## Requirements
  71. **Runtime:** Java 17+ (raised from Java 11 in MockServer 6.0.0 — see the [Java 17 / Jakarta upgrade guide](docs/operations/migration-java17-jakarta.md); pin to `5.15.x` if you need Java 11). The official Docker image bundles its own JVM, so containerised users need no JVM of their own.
  72. **Building from source:** JDK 17+.
  73. **Security note:** MockServer is a **development and testing tool only** — see [SECURITY.md](SECURITY.md).
  74. ## Documentation
  75. - Usage guide: [www.mock-server.com](https://www.mock-server.com/)
  76. - Architecture, code structure, infrastructure, and operations docs: [docs/](docs/README.md)
  77. - AI/MCP integration: built-in [MCP](https://modelcontextprotocol.io) server at `/mockserver/mcp` — see [llms.txt](https://www.mock-server.com/llms.txt) and the [AI Integration docs](https://www.mock-server.com/mock_server/ai_mcp_setup.html)
  78. ## Versions
  79. [![Latest release](https://img.shields.io/maven-central/v/org.mock-server/mockserver-netty.svg?label=latest)](https://github.com/mock-server/mockserver-monorepo/releases)
  80. - **What changed:** [changelog](changelog.md) and [GitHub releases](https://github.com/mock-server/mockserver-monorepo/releases) (every version is also a [git tag](https://github.com/mock-server/mockserver-monorepo/tags) `mockserver-<version>`).
  81. - **API docs for a version:** Java API at `https://mock-server.com/versions/<version>/apidocs/index.html`; REST API on [SwaggerHub](https://app.swaggerhub.com/apis/jamesdbloom/mock-server-openapi) (one spec per `major.minor.x`).
  82. - **Java 11:** the last Java 11-compatible release is [5.15.0](https://github.com/mock-server/mockserver-monorepo/tree/mockserver-5.15.0) (January 2023).
  83. > **6.0.0 breaking change:** the `<classifier>shaded</classifier>` Maven form was removed. Replace `mockserver-netty:<version>:shaded` with `mockserver-netty-no-dependencies:<version>` (same shaded bytes, new coordinates).
  84. ## Community & Contributing
  85. - **Issues / bugs / feature requests:** [GitHub Issues](https://github.com/mock-server/mockserver-monorepo/issues?state=open) — please include your MockServer version, how you're running it (Docker, Maven plugin, etc.), and INFO-level (or higher) log output.
  86. - **Discussions:** [GitHub Discussions](https://github.com/mock-server/mockserver-monorepo/discussions)
  87. - **Roadmap:** [GitHub Project](https://github.com/orgs/mock-server/projects/1)
  88. - **Security policy:** [SECURITY.md](SECURITY.md)
  89. - **Community tools:** [MockServer Browser Admin](https://github.com/johnnywang1994/mockserver-browser-admin), a React + TypeScript web UI for managing expectations
  90. - **Contributing:** pull requests are very welcome — read [CONTRIBUTING.md](CONTRIBUTING.md) first, then check the [open issues](https://github.com/mock-server/mockserver-monorepo/issues?state=open) and let us know if you intend to work on something.
  91. ### Maintainers
  92. * [James D Bloom](https://blog.jamesdbloom.com)
.claude/settings.json · Bundled script · 55 lines · 2 findings marked
  1. {
  2. "permissions": {
  3. "allow": [
  4. "Bash(*)",
  5. "Bash(scripts/ci/bk-pipeline-status.sh:*)",
  6. "Bash(./scripts/ci/bk-pipeline-status.sh:*)"
  7. ],
  8. "deny": [
  9. "Bash(git push --force*)",
  10. "Bash(git reset --hard*)",
  11. "Bash(git clean -fd*)",
  12. "Bash(rm -rf .)",
  13. "Bash(rm -rf ..)",
  14. "Bash(rm -rf ~)",
    • Dismissed after review: Runs `rm -rf` against a root or home-directory path
    • Line 14 on GitHub
  15. "Bash(rm -rf /)",
    • Dismissed after review: Runs `rm -rf` against a root or home-directory path
    • Line 15 on GitHub
  16. "Bash(rm -rf /*)"
  17. ]
  18. },
  19. "hooks": {
  20. "PreToolUse": [
  21. {
  22. "matcher": "Bash|Write|Edit|MultiEdit|NotebookEdit|Task|Agent",
  23. "hooks": [
  24. {
  25. "type": "command",
  26. "command": "bash .opencode/scripts/check-halt-hook.sh"
  27. }
  28. ]
  29. },
  30. {
  31. "matcher": "Write|Edit|MultiEdit|NotebookEdit",
  32. "hooks": [
  33. {
  34. "type": "command",
  35. "command": "bash .opencode/scripts/check-bare-checkout-write-hook.sh"
  36. }
  37. ]
  38. }
  39. ],
  40. "Stop": [
  41. {
  42. "hooks": [
  43. {
  44. "type": "command",
  45. "command": "osascript -e 'display notification \"Task completed\" with title \"Claude Code — MockServer\"'"
  46. },
  47. {
  48. "type": "command",
  49. "command": "bash .opencode/scripts/aggregate-telemetry.sh .tmp/decisions --csv .tmp/telemetry-latest.csv >/dev/null 2>&1 || true"
  50. }
  51. ]
  52. }
  53. ]
  54. }
  55. }

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.