Internal Release 0.2.4

- remove activesupport as a runtime dependency
- use alternative to activesupport/inflector methods
- use `json_rpc_handler` gem
- add json_rpc_handler to gem dependencies

Author: atesgoral

Gemfile

@@ -10,6 +10,5 @@ gem "minitest", "~> 5.1", require: false
 gem "rake", "~> 13.0"
 gem "rubocop-shopify", require: false
 
-gem "activesupport"
 gem "minitest-reporters"
 gem "mocha"

Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    model_context_protocol (0.2.2)
-      activesupport
+    model_context_protocol (0.2.4)
+      json_rpc_handler (~> 0.1)
 
 GEM
   remote: https://rubygems.org/
@@ -32,6 +32,7 @@ GEM
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     json (2.11.3)
+    json_rpc_handler (0.1.1)
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
     logger (1.7.0)

README.md

@@ -62,6 +62,7 @@ MCP spec includes [Tools](https://modelcontextprotocol.io/docs/concepts/tools) w
 This gem provides a `ModelContextProtocol::Tool` class that can be used to create tools in two ways:
 
 1. As a class definition:
+
 ```ruby
 class MyTool < ModelContextProtocol::Tool
   tool_name "my_tool"
@@ -77,6 +78,7 @@ tool = MyTool.new
 ```
 
 2. By using the `ModelContextProtocol::Tool.define` method with a block:
+
 ```ruby
 tool = ModelContextProtocol::Tool.define(name: "my_tool", description: "This tool performs specific functionality...") do |args|
   Tool::Response.new([{ type: "text", content: "OK" }])
@@ -90,6 +92,7 @@ MCP spec includes [Prompts](https://modelcontextprotocol.io/docs/concepts/prompt
 The `ModelContextProtocol::Prompt` class provides two ways to create prompts:
 
 1. As a class definition with metadata:
+
 ```ruby
 class MyPrompt < ModelContextProtocol::Prompt
   prompt_name "my_prompt"  # Optional - defaults to underscored class name
@@ -121,6 +124,7 @@ end
 ```
 
 2. Using the `ModelContextProtocol::Prompt.define` method:
+
 ```ruby
 prompt = ModelContextProtocol::Prompt.define(
   name: "my_prompt",
@@ -168,6 +172,7 @@ server = ModelContextProtocol::Server.new(
 ```
 
 The server will handle prompt listing and execution through the MCP protocol methods:
+
 - `prompts/list` - Lists all registered prompts and their schemas
 - `prompts/get` - Retrieves and executes a specific prompt with arguments
 

lib/model_context_protocol.rb

@@ -1,8 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
-require "model_context_protocol/json_rpc"
 require "model_context_protocol/server"
+require "model_context_protocol/string_utils"
 require "model_context_protocol/tool"
 require "model_context_protocol/content"
 require "model_context_protocol/resource"

lib/model_context_protocol/json_rpc/error.rb

@@ -60,7 +60,7 @@ def prompt_name(value)
       end
 
       def name_value
-        @name_value || name.demodulize.underscore
+        @name_value || StringUtils.handle_from_class_name(name)
       end
 
       def description(value)

lib/model_context_protocol/json_rpc/request.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "json_rpc_handler"
+
 module ModelContextProtocol
   class Server
     PROTOCOL_VERSION = "2024-11-05"
@@ -26,20 +28,20 @@ def initialize(name: "model_context_protocol", tools: [], prompts: [], resources
     end
 
     def handle(request)
-      response = begin
-        parsed_request = JsonRPC::Request.parse(request)
-        parsed_request.validate!
-
-        if parsed_request.notification?
-          handle_notification(parsed_request)
+      JsonRpcHandler.handle(request) do |method|
+        handler = case method
+        when "tools/list"
+          ->(params) { { tools: @handlers["tools/list"].call(params) } }
+        when "prompts/list"
+          ->(params) { { prompts: @handlers["prompts/list"].call(params) } }
+        when "resources/list"
+          ->(params) { { resources: @handlers["resources/list"].call(params) } }
         else
-          handle_method(parsed_request)
+          @handlers[method]
         end
-      rescue JsonRPC::Error => e
-        JsonRPC::Response.new(id: parsed_request&.id, error: e)
-      end
 
-      response
+        handler
+      end
     end
 
     def resources_list_handler(&block)
@@ -86,29 +88,6 @@ def server_info
       }
     end
 
-    def handle_notification(request)
-      nil
-    end
-
-    def handle_method(request)
-      request_handler = @handlers[request.method]
-      raise JsonRPC::MethodNotFoundError.new(message: "Method not found #{request.method}") unless request_handler
-
-      result = request_handler.call(request)
-      wrapped_result = case request.method
-      when "tools/list"
-        { tools: result }
-      when "prompts/list"
-        { prompts: result }
-      when "resources/list"
-        { resources: result }
-      else
-        result
-      end
-
-      JsonRPC::Response.new(id: request.id, result: wrapped_result)
-    end
-
     def init(request)
       {
         protocolVersion: PROTOCOL_VERSION,
@@ -121,43 +100,33 @@ def ping(request)
       "pong"
     end
 
+    def list_tools(request)
+      @tools.map { |_, tool| tool.to_h }
+    end
+
     def call_tool(request)
-      tool_name = request.params&.dig("name")
+      tool_name = request[:name]
       tool = tools[tool_name]
-      raise JsonRPC::MethodNotFoundError.new(message: "Tool not found #{tool_name}") unless tool
-
-      tool_args = request.params&.dig("arguments")
-
-      result = begin
-        tool.call(**tool_args)
-      rescue => e
-        raise JsonRPC::InternalError.new(message: e.message)
-      end
+      raise "Tool not found #{tool_name}" unless tool
 
+      result = tool.call(**request[:arguments])
       result.to_h
     end
 
-    def list_tools(request)
-      @tools.map { |_, tool| tool.to_h }
-    end
-
     def list_prompts(request)
       @prompts.map { |_, prompt| prompt.to_h }
     end
 
     def get_prompt(request)
-      prompt_name = request.params&.dig("name")
+      prompt_name = request[:name]
       prompt = @prompts[prompt_name]
-      raise JsonRPC::MethodNotFoundError.new(message: "Prompt not found #{prompt_name}") unless prompt
 
-      begin
-        prompt_args = request.params&.dig("arguments")
-        prompt.validate_arguments!(prompt_args)
+      raise "Prompt not found #{prompt_name}" unless prompt
 
-        result = prompt.template(prompt_args)
-      rescue ArgumentError => e
-        raise JsonRPC::InvalidParamsError.new(message: e.message)
-      end
+      prompt_args = request[:arguments]
+      prompt.validate_arguments!(prompt_args)
+
+      result = prompt.template(prompt_args)
 
       result.to_h
     end
@@ -167,10 +136,10 @@ def list_resources(request)
     end
 
     def read_resource(request)
-      resource_uri = request.params&.dig("uri")
+      resource_uri = request[:uri]
 
       resource = @resource_index[resource_uri]
-      raise JsonRPC::MethodNotFoundError.new(message: "Resource not found #{resource_uri}") unless resource
+      raise "Resource not found #{resource_uri}" unless resource
 
       resource.to_h
     end

lib/model_context_protocol/json_rpc/response.rb

@@ -0,0 +1,26 @@
+# typed: strict
+# frozen_string_literal: true
+
+module ModelContextProtocol
+  module StringUtils
+    extend self
+
+    def handle_from_class_name(class_name)
+      underscore(demodulize(class_name))
+    end
+
+    private
+
+    def demodulize(path)
+      path.to_s.split("::").last || path.to_s
+    end
+
+    def underscore(camel_cased_word)
+      camel_cased_word.dup
+        .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+        .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+        .tr("-", "_")
+        .downcase
+    end
+  end
+end