Module: RosettAi::Mcp::ResponseHelper

Defined in:
lib/rosett_ai/mcp/response_helper.rb

Overview

Standardized MCP tool response formatting.

Provides consistent response structure for all MCP tools with success, finding, and error states.

Author:

  • hugo

  • claude

Class Method Summary collapse

Class Method Details

.error(message, data = {}) ⇒ Hash

Build an error response hash.

Parameters:

  • message (String) —

    human-readable error message

  • data (Hash) (defaults to: {}) —

    additional response data

Returns:

  • (Hash) —

    response with error: true



41
42
43
 
# File 'lib/rosett_ai/mcp/response_helper.rb', line 41

def error(message, data = {})
  { error: true, message: message }.merge(data)
end

.finding(message, data = {}) ⇒ Hash

Build a finding response hash (not an error, but notable).

Parameters:

  • message (String) —

    human-readable message

  • data (Hash) (defaults to: {}) —

    additional response data

Returns:

  • (Hash) —

    response with finding: true



32
33
34
 
# File 'lib/rosett_ai/mcp/response_helper.rb', line 32

def finding(message, data = {})
  { finding: true, message: message }.merge(data)
end

.success(message, data = {}) ⇒ Hash

Build a success response hash.

Parameters:

  • message (String) —

    human-readable message

  • data (Hash) (defaults to: {}) —

    additional response data

Returns:

  • (Hash) —

    response with success: true



23
24
25
 
# File 'lib/rosett_ai/mcp/response_helper.rb', line 23

def success(message, data = {})
  { success: true, message: message }.merge(data)
end