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.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-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?
MCP Protocol Validator is a testing suite and reference implementation for the Model Context Protocol (MCP). It provides tools to validate MCP server implementations, including support for protocol version 2025-06-18 with features like OAuth 2.1 authentication, structured tool output, and enhanced security.
How to use MCP Protocol Validator?
Run compliance tests via python -m mcp_testing.scripts.compliance_report for STDIO servers or python -m mcp_testing.scripts.http_compliance_test for HTTP servers. Configure protocol versions, OAuth 2.1, timeouts, and test modes through command-line options and environment variables. A reference HTTP server is provided for testing.
Key features of MCP Protocol Validator
- OAuth 2.1 authentication support with Bearer token validation
- STDIO and HTTP compliance test suites
- Support for protocol versions 2024-11-05, 2025-03-26, 2025-06-18
- Structured tool output and enhanced tool schema validation
- Detailed test reports with success rates and server capabilities
- Configurable timeouts and selective tool testing
Use cases of MCP Protocol Validator
- Validate custom MCP server implementations against the specification
- Test HTTP servers with OAuth 2.1 authentication enabled
- Ensure backward compatibility with multiple protocol versions
- Automate compliance testing in CI/CD pipelines
- Verify structured tool output and error handling behavior
FAQ from MCP Protocol Validator
What protocol versions does the validator support?
The validator supports protocol versions 2024-11-05, 2025-03-26, and 2025-06-18, with full 2025-06-18 support including OAuth 2.1 and structured tool output.
How do I test an MCP server installed via pip?
Use the --server-command option with the Python module command, e.g., python -m mcp_testing.scripts.compliance_report --server-command "python -m your_server_module" --protocol-version 2024-11-05.
Can I test only specific tools?
Yes, use --test-mode tools and optionally --dynamic-only to automatically discover and test available tools, or --required-tools to specify which tools to test.
How do I enable OAuth 2.1 authentication for tests?
Set environment variables MCP_OAUTH_ENABLED=true, MCP_OAUTH_INTROSPECTION_URL, and optionally MCP_OAUTH_REQUIRED_SCOPES before starting the reference HTTP server, then run the HTTP compliance test suite.
What kind of test reports does the validator generate?
Each test run produces a report including server information, protocol version, test duration, success rate, detailed results per test case, server capabilities, and session information.
Frequently asked questions
What protocol versions does the validator support?
The validator supports protocol versions 2024-11-05, 2025-03-26, and 2025-06-18, with full 2025-06-18 support including OAuth 2.1 and structured tool output.
How do I test an MCP server installed via pip?
Use the `--server-command` option with the Python module command, e.g., `python -m mcp_testing.scripts.compliance_report --server-command "python -m your_server_module" --protocol-version 2024-11-05`.
Can I test only specific tools?
Yes, use `--test-mode tools` and optionally `--dynamic-only` to automatically discover and test available tools, or `--required-tools` to specify which tools to test.
How do I enable OAuth 2.1 authentication for tests?
Set environment variables `MCP_OAUTH_ENABLED=true`, `MCP_OAUTH_INTROSPECTION_URL`, and optionally `MCP_OAUTH_REQUIRED_SCOPES` before starting the reference HTTP server, then run the HTTP compliance test suite.
What kind of test reports does the validator generate?
Each test run produces a report including server information, protocol version, test duration, success rate, detailed results per test case, server capabilities, and session information.
Basic information
More Other MCP servers
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
Blender
ahujasidOpen-source MCP to use Blender with any LLM
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Comments