Testing Framework

Testing Framework

Test MCP Apps and any MCP server in CI, without host accounts, tunnels or AI credits.

View .mdEdit on GitHub

moonpeak tests at five levels. Start with the first and add the others when you need them.

Level Command Needs Speed
In-process checks moonpeak test nothing seconds
E2E moonpeak test --e2e Chromium (Playwright) seconds
Visual regression moonpeak test --visual Chromium seconds
Evals moonpeak test --eval provider API keys depends on the model
Any MCP server --server <url> a running server same as above

All of them read the same simulations: JSON fixtures that also drive the inspector, so the scenario you look at is the scenario you test.

  moonpeak test my-app

  ✓ schema     plan-night
  ✓ view       ui://my-app/review.html
  ✓ sim        plan-night#dark-new-moon-night
  ✗ sim        plan-night#bad-date
      expected isError true, got false

  1 failed · 21 checks · 7.1s

Ready-made CI setup: CI.