mcptest

<div align="center">

[](https://golang.org/) [](LICENSE) [](.) [](https://modelcontextprotocol.io/)

CLI testing framework for MCP (Model Context Protocol) servers.

Validate protocol compliance, test tools/resources/prompts, benchmark performance, and ensure spec conformance for CI/CD pipelines.

</div>

---

MCP is the dominant protocol for AI agent tool integration. Thousands of MCP servers exist, but there is no dedicated testing framework. Server authors write ad-hoc tests or test manually with mcp-inspector. This means:

• Incomplete protocol compliance -- missing error codes, malformed responses silently pass
• No regression testing across MCP spec versions
• No CI/CD integration for MCP server validation
• No performance benchmarking for tool call latency

mcptest fills this gap. It is the pytest for MCP servers.

go install github.com/JSLEEKR/mcptest/cmd/mcptest@latest

# Test a stdio MCP server
mcptest run --cmd "node server.js"

# Test a Python MCP server
mcptest run --cmd "python server.py"

# Test a Go MCP server
mcptest run --cmd "go run ./server"

# Test an SSE MCP server
mcptest run --url http://localhost:3000/sse

mcptest - MCP Server Testing Framework
==================================================
Server: node server.js
Transport: stdio

Suite: compliance (9 passed, 0 failed, 0 skipped, 0 errors)
--------------------------------------------------
  [PASS] initialize handshake - server: my-server v1.0.0 (0.012s)
  [PASS] initialize response has protocolVersion - protocol ver