mcp

func DBWithOperator ¶

func DBWithOperator(ctx context.Context, db orm.DB) orm.DB

DBWithOperator returns a database connection with the operator ID bound from the MCP context.

func GetPrincipalFromContext ¶

func GetPrincipalFromContext(ctx context.Context) *security.Principal

GetPrincipalFromContext extracts the Principal from MCP request context.

func MustSchemaFor ¶

func MustSchemaFor[T any]() map[string]any

MustSchemaFor is like SchemaFor but panics on error.

func MustSchemaOf ¶

func MustSchemaOf(v any) map[string]any

MustSchemaOf is like SchemaOf but panics on error.

func SchemaFor ¶

func SchemaFor[T any]() map[string]any

SchemaFor returns a JSON Schema for the type T. This follows the same naming convention as reflect.TypeFor.

The generated schema is suitable for use as MCP Tool.InputSchema or output schema.

Usage:

type MyInput struct {
    Name string `json:"name" jsonschema:"required,description=The name"`
    Age  int    `json:"age,omitempty" jsonschema:"minimum=0,maximum=150"`
}

schema := mcp.SchemaFor[MyInput]()

Supported jsonschema tags (use `jsonschema:"tag1,tag2=value"`):

Generic (all types):

• required: marks the field as required
• title=xxx: field title
• description=xxx: field description
• default=xxx: default value
• example=xxx: example value (can be repeated)
• enum=A,enum=B: enumeration values
• oneof_type=string;integer: field can be one of multiple types
• anyof_type=string;integer: field can be any of multiple types

String type:

• minLength=N: minimum string length
• maxLength=N: maximum string length
• pattern=xxx: regex pattern
• format=xxx: format hint (email, uri, uuid, date-time, date, time, ipv4, ipv6, etc.)
• readOnly=true: field is read-only
• writeOnly=true: field is write-only

Number/Integer type:

• minimum=N: minimum value
• maximum=N: maximum value
• exclusiveMinimum=N: exclusive minimum value
• exclusiveMaximum=N: exclusive maximum value
• multipleOf=N: value must be multiple of N

Array type:

• minItems=N: minimum array length
• maxItems=N: maximum array length
• uniqueItems=true: items must be unique

Additional tags:

• jsonschema_description:"xxx": standalone description tag
• jsonschema_extras:"a=b,c=d": add custom schema properties

func SchemaOf ¶

func SchemaOf(v any) map[string]any

SchemaOf returns a JSON Schema for the type of v. This follows the same naming convention as reflect.TypeOf.

If v is nil, SchemaOf returns nil.