mcp-server-tester

[](https://github.com/ollieb89/ai-devops-actions)

[](https://github.com/ollieb89/mcp-server-tester/actions/workflows/ci.yml) [](https://www.npmjs.com/package/mcp-server-tester) [](LICENSE) [](https://github.com/ollieb89/mcp-server-tester/releases)

> The first GitHub Action + CLI for testing MCP servers in CI.

The Model Context Protocol (MCP) ecosystem is exploding — Google ADK, enterprise tool platforms, and thousands of community servers. mcp-server-tester gives you health checks, protocol compliance validation, tool/resource/prompt schema validation, and CI reports for any MCP server.

• Health Check — connect to the server and verify it responds to the MCP initialize handshake
• Protocol Compliance — validate protocol version, capabilities, serverInfo against the 2024-11-05 spec
• Tool Discovery — enumerate tools, validate schemas (name, description, inputSchema)
• Resource Discovery — enumerate resources, validate URIs and mimeTypes
• Prompt Discovery — enumerate prompts, validate argument schemas
• CI Report — GitHub Actions job summary + JSON artifact with full results
• CLI — use via npx mcp-server-tester in any shell or CI script
• Fail policy — configurable fail-on: errors | warnings | none

| Transport | Description | |-----------|-------------| | stdio | Start server as subprocess, communicate over stdin/stdout | | http | Connect to HTTP endpoint (health check only in MVP) | | sse | Connect to SSE endpoint (health check only in MVP) |