ruby-mcp-client 0.8.1 → 0.9.0

data/lib/mcp_client/tool.rb

@@ -8,20 +8,28 @@ module MCPClient
     # @!attribute [r] description
     #   @return [String] the description of the tool
     # @!attribute [r] schema
-    #   @return [Hash] the JSON schema for the tool
+    #   @return [Hash] the JSON schema for the tool inputs
+    # @!attribute [r] output_schema
+    #   @return [Hash, nil] optional JSON schema for structured tool outputs (MCP 2025-06-18)
+    # @!attribute [r] annotations
+    #   @return [Hash, nil] optional annotations describing tool behavior (e.g., readOnly, destructive)
     # @!attribute [r] server
     #   @return [MCPClient::ServerBase, nil] the server this tool belongs to
-    attr_reader :name, :description, :schema, :server
+    attr_reader :name, :description, :schema, :output_schema, :annotations, :server
 
     # Initialize a new Tool
     # @param name [String] the name of the tool
     # @param description [String] the description of the tool
-    # @param schema [Hash] the JSON schema for the tool
+    # @param schema [Hash] the JSON schema for the tool inputs
+    # @param output_schema [Hash, nil] optional JSON schema for structured tool outputs (MCP 2025-06-18)
+    # @param annotations [Hash, nil] optional annotations describing tool behavior
     # @param server [MCPClient::ServerBase, nil] the server this tool belongs to
-    def initialize(name:, description:, schema:, server: nil)
+    def initialize(name:, description:, schema:, output_schema: nil, annotations: nil, server: nil)
       @name = name
       @description = description
       @schema = schema
+      @output_schema = output_schema
+      @annotations = annotations
       @server = server
     end
 
@@ -33,10 +41,14 @@ module MCPClient
       # Some servers (Playwright MCP CLI) use 'inputSchema' instead of 'schema'
       # Handle both string and symbol keys
       schema = data['inputSchema'] || data[:inputSchema] || data['schema'] || data[:schema]
+      output_schema = data['outputSchema'] || data[:outputSchema]
+      annotations = data['annotations'] || data[:annotations]
       new(
         name: data['name'] || data[:name],
         description: data['description'] || data[:description],
         schema: schema,
+        output_schema: output_schema,
+        annotations: annotations,
         server: server
       )
     end
@@ -74,6 +86,30 @@ module MCPClient
       }
     end
 
+    # Check if the tool is marked as read-only
+    # @return [Boolean] true if the tool is read-only
+    def read_only?
+      @annotations && @annotations['readOnly'] == true
+    end
+
+    # Check if the tool is marked as destructive
+    # @return [Boolean] true if the tool is destructive
+    def destructive?
+      @annotations && @annotations['destructive'] == true
+    end
+
+    # Check if the tool requires confirmation before execution
+    # @return [Boolean] true if the tool requires confirmation
+    def requires_confirmation?
+      @annotations && @annotations['requiresConfirmation'] == true
+    end
+
+    # Check if the tool supports structured outputs (MCP 2025-06-18)
+    # @return [Boolean] true if the tool has an output schema defined
+    def structured_output?
+      !@output_schema.nil? && !@output_schema.empty?
+    end
+
     private
 
     # Recursively remove "$schema" keys that are not accepted by Vertex AI

data/lib/mcp_client/version.rb

@@ -2,8 +2,8 @@
 
 module MCPClient
   # Current version of the MCP client gem
-  VERSION = '0.8.1'
+  VERSION = '0.9.0'
 
   # MCP protocol version (date-based) - unified across all transports
-  PROTOCOL_VERSION = '2025-03-26'
+  PROTOCOL_VERSION = '2025-06-18'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-mcp-client
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Szymon Kurcab
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-17 00:00:00.000000000 Z
+date: 2025-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -120,6 +120,7 @@ files:
 - README.md
 - lib/mcp_client.rb
 - lib/mcp_client/auth.rb
+- lib/mcp_client/auth/browser_oauth.rb
 - lib/mcp_client/auth/oauth_provider.rb
 - lib/mcp_client/client.rb
 - lib/mcp_client/config_parser.rb