Skip to content
Back to search

mcp-schema-fuzzer

Zero-dependency Python CLI that validates Model Context Protocol (MCP) JSON-RPC tool schemas and runs boundary/type fuzz tests against local stdio/HTTP MCP servers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dungfundopt--mcp-schema-fuzzer/badge.svg)](/listings/dungfundopt--mcp-schema-fuzzer)

HTML

<a href="/listings/dungfundopt--mcp-schema-fuzzer"><img src="/api/listings/dungfundopt--mcp-schema-fuzzer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Clone this repository 2. Ensure you have Python 3.10+ 3. Make the CLI executable (optional):

   chmod +x cli.py

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 100 lines
  1. # MCP Schema Fuzzer
  2. A zero-dependency Python CLI tool for validating Model Context Protocol (MCP) JSON-RPC schemas and running boundary/type fuzz tests against local stdio or HTTP servers.
  3. ## Features
  4. - Validate MCP JSON-RPC schemas
  5. - Generate fuzz test cases based on schema definitions
  6. - Test against local stdio or remote HTTP servers
  7. - Pure Python implementation (no third-party dependencies)
  8. ## Installation
  9. 1. Clone this repository
  10. 2. Ensure you have Python 3.10+
  11. 3. Make the CLI executable (optional):
  12. ```bash
  13. chmod +x cli.py
  14. ```
  15. ## Usage
  16. ### Basic Validation
  17. ```bash
  18. python cli.py path/to/schema.json
  19. ```
  20. ### Testing Against a Server
  21. ```bash
  22. python cli.py path/to/schema.json --server http://localhost:8000/api
  23. ```
  24. ### Custom Test Count
  25. ```bash
  26. python cli.py path/to/schema.json --count 20
  27. ```
  28. ### Save Results to File
  29. ```bash
  30. python cli.py path/to/schema.json --output results.json
  31. ```
  32. ## Schema Format
  33. The tool expects a JSON schema in the following format:
  34. ```json
  35. {
  36. "type": "object",
  37. "properties": {
  38. "field1": {
  39. "type": "string",
  40. "minLength": 1,
  41. "maxLength": 100
  42. },
  43. "field2": {
  44. "type": "integer",
  45. "minimum": 0,
  46. "maximum": 100
  47. }
  48. },
  49. "required": ["field1"]
  50. }
  51. ```
  52. ## Example Output
  53. ```json
  54. [
  55. {
  56. "input": {
  57. "name": "Test User",
  58. "age": 30,
  59. "active": true
  60. },
  61. "status": "valid"
  62. },
  63. {
  64. "input": {
  65. "name": "",
  66. "age": 150
  67. },
  68. "errors": [
  69. "Field name must have minimum length of 1",
  70. "Field age must be less than or equal to 120"
  71. ],
  72. "status": "invalid"
  73. }
  74. ]
  75. ```
  76. ## Development
  77. Run tests with:
  78. ```bash
  79. python -m unittest test_cli.py
  80. ```
  81. ## License
  82. MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.