ruby-mcp-client 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe40b5481b8c0b59201585bfe54fb912c71235d4f02ada0c8a32a908155c319d
-  data.tar.gz: a378e9f8bd616e92739d371dfb458fc9385a6f2bbc62287cdf1e705742cfa6e0
+  metadata.gz: 87cf7d5701adff89363dd653d263189bded230a32232bbbb496d41b4092afdec
+  data.tar.gz: 9a3561d2f97f0ef518cf75dfce82a8521140c9cdc381aaef3f3b3658265a7298
 SHA512:
-  metadata.gz: 19cb60e6ebf6693a3ee312e592b94e891b568bb67fc675b732d3c32c6452260486fe3f7197a4626e933096cbb52ae4afae8aaed763906fba3041adcadb7ee8ce
-  data.tar.gz: c4c9d8a8b7aaf40d277bd20cb7aa50caf1ade083d6569e9825bb6dc53378d1359ef40e7dab84397416df950887b705abca7738179f639bd965ecb23e3d8186ea
+  metadata.gz: 361f1916a531f14ded3292e15ea4947b0e3715d71d2be71dd24ea198616a82c55e516379a59a455b6c14f9fb7b3b9a1d02bdd457fde0b975ece6320bbb6da23b
+  data.tar.gz: b38270ec5a9ddce3a3689e6c8fb6e86efaa35453b6bcc8a590612d02fe1ef86040d62fd30fb95ff02640bb7b822bf8f473ae24fd571ad696069657f98a9d5c20

data/README.md

@@ -99,6 +99,11 @@ client.send_rpc('custom_method', params: { key: 'value' }, server: :sse) # Uses
 result = client.send_rpc('another_method', params: { data: 123 }) # Uses first available server
 client.send_notification('status_update', params: { status: 'ready' })
 
+# Check server connectivity 
+client.ping # Basic connectivity check
+client.ping({ echo: "hello" }) # With optional parameters 
+client.ping({}, server_index: 1) # Ping a specific server by index
+
 # Clear cached tools to force fresh fetch on next list
 client.clear_cache
 # Clean up connections
@@ -215,6 +220,9 @@ The SSE client implementation provides these key features:
 - **Custom RPC methods**: Send any custom JSON-RPC method or notification through `send_rpc` and `send_notification`
 - **Configurable retries**: All RPC requests support configurable retries with exponential backoff
 - **Consistent logging**: Tagged, leveled logging across all components for better debugging
+- **Graceful fallbacks**: Automatic fallback to synchronous HTTP when SSE connection fails
+- **URL normalization**: Consistent URL handling that respects user-provided formats
+- **Server connectivity check**: Built-in `ping` method to test server connectivity and health
 
 ## Requirements
 

data/lib/mcp_client/client.rb

@@ -163,6 +163,28 @@ module MCPClient
       end
     end
 
+    # Ping the MCP server to check connectivity
+    # @param params [Hash] optional parameters for the ping request
+    # @param server_index [Integer, nil] optional index of a specific server to ping, nil for first available
+    # @return [Object] result from the ping request
+    # @raise [MCPClient::Errors::ServerNotFound] if no server is available
+    def ping(params = {}, server_index: nil)
+      if server_index.nil?
+        # Ping first available server
+        raise MCPClient::Errors::ServerNotFound, 'No server available for ping' if @servers.empty?
+
+        @servers.first.ping(params)
+      else
+        # Ping specified server
+        if server_index >= @servers.length
+          raise MCPClient::Errors::ServerNotFound,
+                "Server at index #{server_index} not found"
+        end
+
+        @servers[server_index].ping(params)
+      end
+    end
+
     private
 
     # Validate parameters against tool JSON schema (checks required properties)

data/lib/mcp_client/server_base.rb

@@ -45,6 +45,13 @@ module MCPClient
       raise NotImplementedError, 'Subclasses must implement rpc_notify'
     end
 
+    # Ping the MCP server to check connectivity
+    # @param params [Hash] optional parameters for the ping request
+    # @return [Object] result from the ping request
+    def ping(params = {})
+      rpc_request('ping', params)
+    end
+
     # Register a callback to receive JSON-RPC notifications
     # @yield [method, params] invoked when a notification is received
     # @return [void]

data/lib/mcp_client/server_sse.rb

@@ -26,7 +26,8 @@ module MCPClient
       @logger.formatter = proc { |severity, _datetime, progname, msg| "#{severity} [#{progname}] #{msg}\n" }
       @max_retries = retries
       @retry_backoff = retry_backoff
-      @base_url = base_url.end_with?('/') ? base_url : "#{base_url}/"
+      # Normalize base_url: strip any trailing slash, use exactly as provided
+      @base_url = base_url.chomp('/')
       @headers = headers.merge({
                                  'Accept' => 'text/event-stream',
                                  'Cache-Control' => 'no-cache',
@@ -45,6 +46,8 @@ module MCPClient
       @connection_established = false
       @connection_cv = @mutex.new_cond
       @initialized = false
+      # Whether to use SSE transport; may disable if handshake fails
+      @use_sse = true
     end
 
     # Stream tool call fallback for SSE transport (yields single result)
@@ -230,12 +233,13 @@ module MCPClient
 
     private
 
-    # Ensure handshake initialization has been performed
+    # Ensure SSE initialization handshake has been performed
     def ensure_initialized
       return if @initialized
 
       connect
       perform_initialize
+
       @initialized = true
     end
 
@@ -286,6 +290,7 @@ module MCPClient
             http.request(request) do |response|
               unless response.is_a?(Net::HTTPSuccess) && response['content-type']&.start_with?('text/event-stream')
                 @mutex.synchronize do
+                  # Signal connection attempt completed (failed)
                   @connection_established = false
                   @connection_cv.broadcast
                 end
@@ -293,7 +298,10 @@ module MCPClient
               end
 
               @mutex.synchronize do
+                # Signal connection established and SSE ready
                 @sse_connected = true
+                @connection_established = true
+                @connection_cv.broadcast
               end
 
               response.read_body do |chunk|
@@ -303,6 +311,11 @@ module MCPClient
             end
           end
         rescue StandardError
+          # On any SSE thread error, signal connection as established to unblock connect
+          @mutex.synchronize do
+            @connection_established = true
+            @connection_cv.broadcast
+          end
           nil
         ensure
           sse_http&.finish if sse_http&.started?
@@ -499,37 +512,31 @@ module MCPClient
             raise MCPClient::Errors::ServerError, "Server returned error: #{response.code} #{response.message}"
           end
 
-          if response.code == '202'
+          # If SSE transport is enabled, retrieve the result via the SSE channel
+          if @use_sse
             request_id = request[:id]
-
             start_time = Time.now
-            timeout = 10
+            timeout = @read_timeout || 10
             result = nil
 
             loop do
               @mutex.synchronize do
-                if @sse_results[request_id]
-                  result = @sse_results[request_id]
-                  @sse_results.delete(request_id)
-                end
+                result = @sse_results.delete(request_id) if @sse_results.key?(request_id)
               end
-
               break if result || (Time.now - start_time > timeout)
 
               sleep 0.1
             end
-
             return result if result
 
             raise MCPClient::Errors::ToolCallError, "Timeout waiting for SSE result for request #{request_id}"
-
-          else
-            begin
-              data = JSON.parse(response.body)
-              return data['result']
-            rescue JSON::ParserError => e
-              raise MCPClient::Errors::TransportError, "Invalid JSON response from server: #{e.message}"
-            end
+          end
+          # Fallback: parse synchronous HTTP JSON response
+          begin
+            data = JSON.parse(response.body)
+            return data['result']
+          rescue JSON::ParserError => e
+            raise MCPClient::Errors::TransportError, "Invalid JSON response from server: #{e.message}"
           end
         end
       ensure

data/lib/mcp_client/version.rb

@@ -2,5 +2,5 @@
 
 module MCPClient
   # Current version of the MCP client gem
-  VERSION = '0.4.0'
+  VERSION = '0.4.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-mcp-client
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Szymon Kurcab