ExMCP.Content.SchemaValidator (ex_mcp v1.0.0-rc.5)

Copy Markdown View Source

Schema validation for MCP content.

Experimental

Helper utilities outside the core Handler/DSL path. Prefer tool output_schema on ExMCP.Server.DSL for structured tool results.

Field/size/MIME helpers are implemented. validate_schema/2 uses ExJsonSchema when available.

Summary

Types

validation_error()
validation_result()

Functions

validate_format(content)

Validates content format and structure.

validate_max_size(arg1, max_size)

Validates content size against maximum limits.

validate_mime_types(arg1, allowed_types)

Validates MIME types against allowed types.

validate_required_fields(arg1)

Validates that required fields are present and non-empty.

validate_schema(content, schema)

Validates content against a JSON Schema using ExJsonSchema.

Types

validation_error()

@type validation_error() :: %{
  rule: atom(),
  message: String.t(),
  field: String.t() | nil,
  value: any(),
  severity: :error | :warning | :info
}

validation_result()

@type validation_result() :: :ok | {:error, [validation_error()]}

Functions

validate_format(content)

@spec validate_format(ExMCP.Content.Protocol.content()) :: validation_result()

Validates content format and structure.

validate_max_size(arg1, max_size)

@spec validate_max_size(ExMCP.Content.Protocol.content(), pos_integer()) ::
  validation_result()

Validates content size against maximum limits.

validate_mime_types(arg1, allowed_types)

@spec validate_mime_types(ExMCP.Content.Protocol.content(), [String.t()]) ::
  validation_result()

Validates MIME types against allowed types.

validate_required_fields(arg1)

@spec validate_required_fields(ExMCP.Content.Protocol.content()) ::
  validation_result()

Validates that required fields are present and non-empty.

validate_schema(content, schema)

@spec validate_schema(ExMCP.Content.Protocol.content() | map(), map()) ::
  validation_result()

Validates content against a JSON Schema using ExJsonSchema.

Content maps are converted to JSON-compatible string-keyed maps (atoms become strings) before validation.