Class: ActionMCP::Content::Resource

Inherits:
Base
  • Object
show all
Defined in:
lib/action_mcp/content/resource.rb

Overview

Resource content references a server-managed resource. It includes a URI, MIME type, and optionally text content or a base64-encoded blob.

Instance Attribute Summary collapse

Attributes inherited from Base

#type

Instance Method Summary collapse

Methods inherited from Base

#to_json

Constructor Details

#initialize(uri, mime_type = "text/plain", text: nil, blob: nil, annotations: nil, meta: nil) ⇒ Resource

Initializes a new Resource content.

Parameters:

  • uri (String) —

    The URI of the resource.

  • mime_type (String) (defaults to: "text/plain") —

    The MIME type of the resource.

  • text (String, nil) (defaults to: nil) —

    The text content of the resource (optional).

  • blob (String, nil) (defaults to: nil) —

    The base64-encoded blob of the resource (optional).

  • annotations (Hash, nil) (defaults to: nil) —

    Optional annotations for the resource.

  • meta (Hash, #to_hash, #to_h, nil) (defaults to: nil) —

    Optional extension metadata. Emitted on the wire as ‘_meta`.



23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
 
# File 'lib/action_mcp/content/resource.rb', line 23

def initialize(uri, mime_type = "text/plain", text: nil, blob: nil, annotations: nil, meta: nil)
  super("resource", annotations: annotations)
  @uri = uri
  @mime_type = mime_type
  @text = text
  @blob = blob
  @annotations = annotations
  @meta =
    if meta.nil?
      nil
    elsif meta.respond_to?(:to_hash)
      meta.to_hash
    elsif meta.respond_to?(:to_h)
      meta.to_h
    else
      raise ArgumentError, "meta must respond to :to_hash or :to_h, got: #{meta.class}"
    end
end

Instance Attribute Details

#annotations ⇒ String, ... (readonly)

Returns:

  • (String) —

    The URI of the resource.

  • (String) —

    The MIME type of the resource.

  • (String, nil) —

    The text content of the resource (optional).

  • (String, nil) —

    The base64-encoded blob of the resource (optional).

  • (Hash, nil) —

    Optional extension metadata (serialized on the wire as ‘_meta`).



13
14
15
 
# File 'lib/action_mcp/content/resource.rb', line 13

def annotations
  @annotations
end

#blob ⇒ String, ... (readonly)

Returns:

  • (String) —

    The URI of the resource.

  • (String) —

    The MIME type of the resource.

  • (String, nil) —

    The text content of the resource (optional).

  • (String, nil) —

    The base64-encoded blob of the resource (optional).

  • (Hash, nil) —

    Optional extension metadata (serialized on the wire as ‘_meta`).



13
14
15
 
# File 'lib/action_mcp/content/resource.rb', line 13

def blob
  @blob
end

#meta ⇒ String, ... (readonly)

Returns:

  • (String) —

    The URI of the resource.

  • (String) —

    The MIME type of the resource.

  • (String, nil) —

    The text content of the resource (optional).

  • (String, nil) —

    The base64-encoded blob of the resource (optional).

  • (Hash, nil) —

    Optional extension metadata (serialized on the wire as ‘_meta`).



13
14
15
 
# File 'lib/action_mcp/content/resource.rb', line 13

def meta
  @meta
end

#mime_type ⇒ String, ... (readonly)

Returns:

  • (String) —

    The URI of the resource.

  • (String) —

    The MIME type of the resource.

  • (String, nil) —

    The text content of the resource (optional).

  • (String, nil) —

    The base64-encoded blob of the resource (optional).

  • (Hash, nil) —

    Optional extension metadata (serialized on the wire as ‘_meta`).



13
14
15
 
# File 'lib/action_mcp/content/resource.rb', line 13

def mime_type
  @mime_type
end

#text ⇒ String, ... (readonly)

Returns:

  • (String) —

    The URI of the resource.

  • (String) —

    The MIME type of the resource.

  • (String, nil) —

    The text content of the resource (optional).

  • (String, nil) —

    The base64-encoded blob of the resource (optional).

  • (Hash, nil) —

    Optional extension metadata (serialized on the wire as ‘_meta`).



13
14
15
 
# File 'lib/action_mcp/content/resource.rb', line 13

def text
  @text
end

#uri ⇒ String, ... (readonly)

Returns:

  • (String) —

    The URI of the resource.

  • (String) —

    The MIME type of the resource.

  • (String, nil) —

    The text content of the resource (optional).

  • (String, nil) —

    The base64-encoded blob of the resource (optional).

  • (Hash, nil) —

    Optional extension metadata (serialized on the wire as ‘_meta`).



13
14
15
 
# File 'lib/action_mcp/content/resource.rb', line 13

def uri
  @uri
end

Instance Method Details

#to_h ⇒ Hash

Returns a hash representation of the resource content. Per MCP spec, embedded resources have type “resource” with a nested resource object. ‘meta` is emitted as `_meta` on the inner resource hash (TextResourceContents / BlobResourceContents), not on the outer content envelope.

Returns:

  • (Hash) —

    The hash representation of the resource content.



48
49
50
51
52
53
54
55
56
 
# File 'lib/action_mcp/content/resource.rb', line 48

def to_h
  inner = { uri: @uri, mimeType: @mime_type }
  inner[:text] = @text if @text
  inner[:blob] = @blob if @blob
  inner[:annotations] = @annotations if @annotations
  inner[:_meta] = @meta if @meta && !@meta.empty?

  { type: @type, resource: inner }
end