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-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.
Frequently asked questions
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.
Basic information
More Other MCP servers
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!
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Codelf
unbugA search tool helps dev to solve the naming things problem.
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Comments