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

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/3 uses ExJsonSchema behind ExMCP.Content.SchemaPolicy, which rejects remote references and bounds schema complexity and execution time.

Summary

Types

validation_error()

validation_result()

Functions

compile_schema(schema, opts \\ [])

Preflights and resolves a JSON Schema under ExMCP's resource policy.

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, opts \\ [])

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

compile_schema(schema, opts \\ [])

@spec compile_schema(
  map() | boolean(),
  keyword()
) :: ExMCP.Content.SchemaPolicy.compile_result()

Preflights and resolves a JSON Schema under ExMCP's resource policy.

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, opts \\ [])

@spec validate_schema(
  ExMCP.Content.Protocol.content() | map(),
  map() | boolean(),
  keyword()
) ::
  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.