MockServe — Lightweight API Mock Server from JSON Config

Designed for frontend teams and CI pipelines

Stop waiting for backend. Mock responses, delays, errors — all in a single JSON file.

⚡ Zero-Config Startup

One JSON file defines all routes. Run python -m src.cli config.json and you're live on localhost:8080.

🔧 Full HTTP Support

GET, POST, PUT, DELETE, PATCH. Custom status codes, headers, request bodies, and dynamic path matching.

⏱️ Simulated Latency

Add "delay": 1.5 to any route to test loading states, timeouts, and race conditions.

🧪 Error Injection

Return 4xx, 5xx, or custom error payloads to test error boundaries and retry logic.

📦 Zero Dependencies

Pure Python standard library (http.server, socketserver, json). Runs anywhere Python runs — including CI containers.

🔄 Hot Reload Ready

Restart in <500ms. Perfect for TDD loops — edit JSON, rerun tests, no container rebuilds.

Config-driven, version-controllable

Your mock API lives in git alongside your frontend code.

# mock-config.json
{
  "routes": {
    "GET:/api/users": {
      "status": 200,
      "body": [{"id": 1, "name": "Alice"}, {"id": 2, "name": "Bob"}]
    },
    "POST:/api/users": {
      "status": 201,
      "body": {"id": 3, "name": "Created"}
    },
    "GET:/api/health": {
      "status": 200,
      "body": {"status": "ok"}
    }
  }
}

# Run server
python -m src.cli mock-config.json --port 8080

# Test it
curl http://localhost:8080/api/users
curl -X POST http://localhost:8080/api/users -d '{"name": "Carol"}'
            

Free and open source

Use it under the MIT license. Sponsor ongoing work with USDT on the TON network if it saves development time.

MIT License

Free

Unlimited projects

Full source code
MIT license
Public issue tracker
Direct GitHub download

Pay in USDT on TON network 🔗 Open in TON wallet

Select USDT in your wallet.
Select the TON network.
Copy the address below and send USDT only.

UQDHA5jEi88JRomsstaA-srnIJyayuK95FsGuXI6_B2Cngbk

No amount is prefilled.

Get in touch

Questions? Feature requests? Just say hello.

For paid custom mocks or utilities, request a fixed quote through the portfolio form.

Request custom work

GitHub GitHub Profile

Mock APIs in seconds, not hours.