GripMock

Appearance

Introduction ​

GripMock

GripMock is your go-to tool for testing gRPC services. It creates a mock server that responds exactly how you want it to, making testing faster and more reliable.

What is GripMock? ​

GripMock is a mock server for gRPC services. Give it your .proto files, and it instantly creates a working server that responds with your predefined test data. Perfect for testing your applications without needing a real backend server.

Why Use GripMock? ​

  • Fast Setup: Get a working server in seconds
  • Easy Testing: Define responses in simple YAML or JSON files
  • Real Scenarios: Test file uploads, chat applications, and data streaming
  • No Dependencies: Works with any programming language that supports gRPC
  • Production Ready: Built-in health checks and Docker support

Key Features ​

  • Quick Start: Use your .proto files to generate a server instantly
  • YAML & JSON: Define your test responses in the format you prefer
  • Health Monitoring: Built-in health checks for production deployment
  • Header Testing: Test different authentication tokens and headers
  • Error Simulation: Test how your app handles real-world errors
  • File Upload Testing: Test chunked file uploads and batch processing
  • Real-time Chat: Test bidirectional streaming for chat applications
  • Web Interface: Manage your test scenarios through a friendly web UI
  • Docker Ready: Lightweight container perfect for CI/CD pipelines
  • 20-35% Faster: Latest improvements make your tests run quicker
  • Zero Breaking Changes: All your existing tests continue to work
  • Extensible Plugins v3.5.0: Extend functionality with custom template functions
  • Match Limit (options.times) v3.7.0: Limit how many times a stub can be matched before fallback logic applies
  • Embedded SDK (Experimental) v3.7.0: Run GripMock directly inside Go tests with history and verification tools
  • MCP API (Experimental) v3.7.0: Integrate AI/agent tooling through a single JSON-RPC endpoint
  • Builder Image for Plugins v3.7.1: Build plugins in :<tag>-builder and run with matching :<tag> for compatibility

Streaming Support ​

GripMock supports all types of gRPC communication:

Simple Requests (1:1) ​

Traditional request-response - you send one message, get one response back.

Data Feeds (1:N) v3.3.0 ​

Send one request, receive multiple responses over time - perfect for real-time data.

File Uploads (N:1) v3.4.0 ​

Send multiple messages (like file chunks), receive one summary response.

Real-time Chat (N:N) v3.4.0 ​

Send and receive messages continuously - ideal for chat apps and live collaboration.

Web Interface v3.0.0 ​

The dashboard provides a user-friendly way to:

  • Create and edit test responses
  • Monitor which responses are being used
  • Manage your test scenarios visually

Access it at http://localhost:4771/ when you start GripMock.

Experimental APIs ​

  • MCP API v3.7.0: Exposed at POST /api/mcp for agent-oriented workflows
  • Embedded SDK v3.7.0: Programmatic GripMock usage in Go tests with built-in verification helpers

Runtime descriptor loading v3.7.0 ​

Need to load .pb descriptors into a running server without restart? See Descriptor API (/api/descriptors).

Getting Started ​

  1. Install: Download or use Docker
  2. Configure: Point to your .proto files
  3. Define Responses: Create YAML/JSON files with your test data
  4. Test: Your mock server is ready!

Need Help? ​

Stuck with something? Check out our GitHub issues page or join our community discussions.