MCP Protocol Validator
@Janix-ai
About MCP Protocol Validator
Test suite for validating MCP server implementations against the open MCP protocol specification. Helps developers ensure protocol compliance and interoperability.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-protocol-validator": {
"command": "python",
"args": [
"mcp_testing/scripts/http_compliance_test.py",
"--debug"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MCP Protocol Validator?
The MCP Protocol Validator is a testing suite and reference implementation for the Model Context Protocol (MCP). It provides a comprehensive environment for testing and validating MCP server implementations, including a testing framework and reference servers to ensure compliance with the MCP specification.
How to use MCP Protocol Validator?
Install and run compliance tests via command-line scripts. For STDIO servers, use python -m mcp_testing.scripts.compliance_report --server-command "python path/to/server.py" --protocol-version 2025-06-18. For HTTP servers, start the reference server and run python -m mcp_testing.scripts.http_compliance_test. Configure OAuth 2.1 via environment variables like MCP_OAUTH_ENABLED=true.
Key features of MCP Protocol Validator?
- OAuth 2.1 authentication testing framework
- STDIO and HTTP compliance test suites
- Multi-protocol version support (2024-11-05 to 2025-06-18)
- Structured tool output and enhanced schema validation
- Protocol version negotiation and error handling tests
- Detailed test report generation
Use cases of MCP Protocol Validator?
- Validate a custom MCP server implementation against the specification
- Test backward compatibility with older protocol versions (2024-11-05, 2025-03-26)
- Verify OAuth 2.1 bearer token handling and security headers
- Automate compliance checks in a CI/CD pipeline
- Debug tool functionality with dynamic discovery and timeout control
FAQ from MCP Protocol Validator
What protocol versions does the validator support?
It supports protocol versions 2024-11-05, 2025-03-26, and the latest 2025-06-18.
Does the validator support both STDIO and HTTP transports?
Yes, it includes separate compliance test suites for STDIO-based servers (compliance_report.py) and HTTP-based servers (http_compliance_test.py).
How do I test a pip-installed MCP server?
Ensure the server is installed in the correct virtual environment, then run python -m mcp_testing.scripts.compliance_report --server-command "python -m your_server_module" --protocol-version 2024-11-05.
Can I test only specific functionality?
Yes, use options like --test-mode tools for tool-only tests, --dynamic-only for automatic tool discovery, and --skip-tests to exclude specific tests.
What authentication does the validator support for HTTP tests?
It fully supports OAuth 2.1 authentication with bearer token validation, WWW-Authenticate headers, and resource server capabilities, configurable via environment variables.
More Other MCP servers
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
EverArt
modelcontextprotocolModel Context Protocol Servers
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
ICSS
chokcoco不止于 CSS
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
Comments