Test MCP Servers
with confidence.
A Jest-inspired testing framework for Model Context Protocol servers. Automated testing, CI/CD ready, zero configuration.
$ npm install -g mcp-jest $ mcp-jest node ./server.js --tools search,email ✓ Weather Server Tests ✓ get-weather (142ms) ✓ list-cities (89ms) Test Suites: 1 passed, 1 total Tests: 2 passed, 2 total Time: 0.531s
npm install -g mcp-jestTesting MCP servers was painful
- ✗Manual testing with every change
- ✗Silent failures in production
- ✗No CI/CD integration
- ✗Debugging without context
- ✗Deploy and pray
Ship with confidence
- ✓Automated testing on every commit
- ✓Instant failure notifications
- ✓Native CI/CD support
- ✓Detailed error reporting
- ✓Deploy with proof
Everything you need
A complete testing toolkit designed specifically for the MCP protocol.
CLI & Programmatic
Use via command line or integrate into your test suites programmatically.
Snapshot Testing
Capture outputs and detect unexpected changes automatically.
Test Filtering
Run specific tests with --filter and --skip patterns.
HTTP Transport
Test servers over stdio, HTTP streaming, or SSE connections.
FastMCP Support
Works with partial MCP implementations and handles errors gracefully.
CI/CD Ready
Native integration with GitHub Actions, GitLab CI, and Jenkins.
30 seconds to your first test
No configuration required. Just install and run.
# 1. Install globally
$ npm install -g mcp-jest
# 2. Test your server's tools
$ mcp-jest node ./my-server.js --tools search,calculate
# 3. Or test over HTTP
$ mcp-jest --transport streamable-http --url http://localhost:3000 --tools search
# 4. Add to your package.json
{
"scripts": {
"test:mcp": "mcp-jest node ./server.js --tools search,email"
}
}Powerful CLI
Complete control over your testing workflow.
| Option | Description |
|---|---|
| --tools <list> | Comma-separated tools to test |
| --transport <type> | stdio, sse, or streamable-http |
| --filter <pattern> | Run only matching tests |
| --skip <pattern> | Skip matching tests |
| --update-snapshots | Update saved snapshots |
| --config <file> | Load configuration from JSON |
Works with everything
Start testing today
Join developers building reliable MCP servers with automated testing.