GripMock

Appearance

GripMockFast, honest gRPC mocks.

gRPC-MockServer

Getting started
Star on GitHub ⭐

  • Runtime `.pb` descriptor loading

    Start from compiled protobuf descriptors (`.pb`), with no proto source tree to manage.

  • MCP API

    Model Context Protocol endpoints, for AI agents and tool-driven automation.

  • No-restart stub updates

    Create, update and remove stubs at runtime through the API or the UI. The process keeps running.

  • Dynamic templates

    Build a response out of the request payload, the headers and the stream position.

  • Request matching

    Exact, partial, regex, glob and header matching, with priority rules deciding which stub answers.

  • Full gRPC streaming

    Unary, server streaming, client streaming and bidirectional.

  • Errors and delays

    Return gRPC status errors, and hold a response back long enough to exercise a client timeout.

  • YAML and JSON stubs

    Both formats, with a JSON Schema for validation and editor autocomplete.

  • Plugin system

    Add template functions in Go for domain-specific behaviour.

  • OpenTelemetry and metrics

    Traces over OTLP, and a `/metrics` endpoint to scrape.

  • Built-in faker

    Generate values from `faker.Person`, `faker.Geo`, `faker.Identity` and seven more domains.

  • Upstream modes (experimental)

    `proxy`, `replay` and `capture` move a test from live upstream traffic to local mocks in stages.

  • Docker ready

    19 MB image for local development, CI and containerized test environments.

  • Embedded SDK (experimental)

    Run GripMock inside a Go test, with no external process to orchestrate.