mcp-rb 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 131c29522f8eb44f7f613f51d92db433370d99950dcfcd27340ab9917b306dd3
-  data.tar.gz: a676110b09851f7018205bc012b09a6f22d1c7730555ba569b9b7ae475c06009
+  metadata.gz: 4ff3f38b8c9fec5aac8fce9d0906f956a77f481ac0477c273e9b677948d0a8cb
+  data.tar.gz: 116def752685bfa0792c6d2b1dc6bd75e6b029cec03205fb2a67b00d84532cfc
 SHA512:
-  metadata.gz: ebe914ec0fa9ba0ef97650f83454d0fe5bf5c924717365d5cea3bdd73bfb06b5e0ede7d49c6da2caa8d38c5a337bae3c98c22b86d5f1c25740785c66ac195509
-  data.tar.gz: 719f1f95950ca24c0695316af978866e1b8834b5112c962701324d8279faa9e5705151157d23a66e7f9e6572313df18f7c4acfc247037965d059f12bdcacb883
+  metadata.gz: 3ed62e7606ff685a999c7f95118167e30d8ecb6a6ff35a260223b60fed2fc65599a79bd22424dfde3b0bfc4cd1b3bdf1cb46dcb6877c7720e8837021f456d8cf
+  data.tar.gz: 5536f506e8e2c89a73fe34acc6edc3981b444672ca8cb3730e089eea22fa9194cee33e6afe26a2442175441487283828aa29103e78b39c8387714d2f1c6a5a82

data/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2025-03-05
+
+### Added
+- Add `resources/templates/list` method: https://github.com/funwarioisii/mcp-rb/pull/5
+
 ## [0.3.0] - 2025-02-19
 
 - Allow specifying the version via DSL keyword: https://github.com/funwarioisii/mcp-rb/pull/2

data/README.md

@@ -19,6 +19,8 @@ require 'mcp'
 
 name "hello-world"
 
+version "1.0.0"
+
 # Define a resource
 resource "hello://world" do
   name "Hello World"
@@ -26,6 +28,13 @@ resource "hello://world" do
   call { "Hello, World!" }
 end
 
+# Define a resource template
+resource_template "hello://{user_name}" do
+  name "Hello User"
+  description "A simple hello user message"
+  call { |args| "Hello, #{args[:user_name]}!" }
+end
+
 # Define a tool
 tool "greet" do
   description "Greet someone by name"
@@ -47,6 +56,7 @@ Reference: [MCP 2024-11-05](https://spec.modelcontextprotocol.io/specification/2
   - Resources
     - resources/read
     - resources/list
+    - resources/templates/list
   - Tools
     - tools/list
     - tools/call
@@ -102,4 +112,3 @@ gem push mcp-rb-*.gem
 ## Changelog
 
 See [CHANGELOG.md](CHANGELOG.md)
-

data/lib/mcp/app/resource.rb

@@ -69,11 +69,11 @@ module MCP
 
         if page_size.nil?
           paginated = values[start_index..]
-          next_cursor = ""
+          next_cursor = nil
         else
           paginated = values[start_index, page_size]
           has_next = start_index + page_size < values.length
-          next_cursor = has_next ? (start_index + page_size).to_s : ""
+          next_cursor = has_next ? (start_index + page_size).to_s : nil
         end
 
         {
@@ -84,6 +84,29 @@ module MCP
 
       def read_resource(uri)
         resource = resources[uri]
+
+        # If no direct match, check if it matches a template
+        if resource.nil? && respond_to?(:find_matching_template)
+          template, variable_values = find_matching_template(uri)
+
+          if template
+            begin
+              # Call the template handler with the extracted variables
+              content = template[:handler].call(variable_values)
+              return {
+                contents: [{
+                  uri: uri,
+                  mimeType: template[:mime_type],
+                  text: content
+                }]
+              }
+            rescue => e
+              raise ArgumentError, "Error reading resource from template: #{e.message}"
+            end
+          end
+        end
+
+        # If we still don't have a resource, raise an error
         raise ArgumentError, "Resource not found: #{uri}" unless resource
 
         begin

data/lib/mcp/app/resource_template.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+
+module MCP
+  class App
+    module ResourceTemplate
+      def resource_templates
+        @resource_templates ||= {}
+      end
+
+      class ResourceTemplateBuilder
+        attr_reader :uri_template, :name, :description, :mime_type, :handler
+
+        def initialize(uri_template)
+          raise ArgumentError, "Resource URI template cannot be nil or empty" if uri_template.nil? || uri_template.empty?
+          @uri_template = uri_template
+          @name = ""
+          @description = ""
+          @mime_type = "text/plain"
+          @handler = nil
+          @variables = extract_variables(uri_template)
+        end
+
+        # standard:disable Lint/DuplicateMethods,Style/TrivialAccessors
+        def name(value)
+          @name = value
+        end
+        # standard:enable Lint/DuplicateMethods,Style/TrivialAccessors
+
+        # standard:disable Lint/DuplicateMethods,Style/TrivialAccessors
+        def description(text)
+          @description = text
+        end
+        # standard:enable Lint/DuplicateMethods,Style/TrivialAccessors
+
+        # standard:disable Lint/DuplicateMethods,Style/TrivialAccessors
+        def mime_type(value)
+          @mime_type = value
+        end
+        # standard:enable Lint/DuplicateMethods,Style/TrivialAccessors
+
+        def call(&block)
+          @handler = block
+        end
+
+        def to_resource_template_hash
+          raise ArgumentError, "Name must be provided" if @name.empty?
+
+          {
+            uri_template: @uri_template,
+            name: @name,
+            mime_type: @mime_type,
+            description: @description,
+            handler: @handler,
+            variables: @variables
+          }
+        end
+
+        # Extract variables from a URI template
+        # e.g., "channels://{channel_id}" => ["channel_id"]
+        def extract_variables(uri_template)
+          variables = []
+          uri_template.scan(/\{([^}]+)\}/) do |match|
+            variables << match[0]&.to_sym
+          end
+          variables
+        end
+
+        # Creates a pattern for matching URIs against this template
+        def to_pattern
+          pattern_string = Regexp.escape(@uri_template).gsub(/\\\{[^}]+\\\}/) do |match|
+            "([^/]+)"
+          end
+          Regexp.new("^#{pattern_string}$")
+        end
+
+        # Extract variable values from a concrete URI based on the template
+        # e.g., template: "channels://{channel_id}", uri: "channels://123" => {"channel_id" => "123"}
+        def extract_variable_values(uri)
+          pattern = to_pattern
+          match = pattern.match(uri)
+          return {} unless match
+
+          result = {}
+          @variables.each_with_index do |var_name, index|
+            result[var_name] = match[index + 1]
+          end
+          result
+        end
+      end
+
+      def register_resource_template(uri_template, &block)
+        builder = ResourceTemplateBuilder.new(uri_template)
+        builder.instance_eval(&block)
+        template_hash = builder.to_resource_template_hash
+        resource_templates[uri_template] = template_hash
+        template_hash
+      end
+
+      # Find a template that matches the given URI and extract variable values
+      def find_matching_template(uri)
+        resource_templates.each do |template_uri, template|
+          builder = ResourceTemplateBuilder.new(template_uri)
+          variable_values = builder.extract_variable_values(uri)
+          return [template, variable_values] unless variable_values.empty?
+        end
+        [nil, {}]
+      end
+
+      def list_resource_templates(cursor: nil, page_size: nil)
+        start_index = cursor&.to_i || 0
+        values = resource_templates.values
+
+        if page_size.nil?
+          paginated = values[start_index..]
+          next_cursor = nil
+        else
+          paginated = values[start_index, page_size]
+          has_next = start_index + page_size < values.length
+          next_cursor = has_next ? (start_index + page_size).to_s : nil
+        end
+
+        {
+          resourceTemplates: paginated.map { |t| format_resource_template(t) },
+          nextCursor: next_cursor
+        }
+      end
+
+      private
+
+      def format_resource_template(template)
+        {
+          uriTemplate: template[:uri_template],
+          name: template[:name],
+          description: template[:description],
+          mimeType: template[:mime_type]
+        }
+      end
+    end
+  end
+end

data/lib/mcp/app/tool.rb

@@ -77,7 +77,7 @@ module MCP
         tool_values = tools.values
         start_index = cursor ? cursor.to_i : 0
         paginated = tool_values[start_index, page_size]
-        next_cursor = (start_index + page_size < tool_values.length) ? (start_index + page_size).to_s : ""
+        next_cursor = (start_index + page_size < tool_values.length) ? (start_index + page_size).to_s : nil
 
         {
           tools: paginated.map { |t| format_tool(t) },

data/lib/mcp/app.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
 require_relative "app/resource"
+require_relative "app/resource_template"
 require_relative "app/tool"
 
 module MCP
   class App
     include Resource
+    include ResourceTemplate
     include Tool
   end
 end

data/lib/mcp/delegator.rb

@@ -15,6 +15,6 @@ module MCP
       end
     end
 
-    delegate :name, :version, :resource, :tool
+    delegate :name, :version, :resource, :resource_template, :tool
   end
 end

data/lib/mcp/server.rb

@@ -28,6 +28,7 @@ module MCP
       return @version if value.nil?
 
       @version = value
+      @supported_protocol_versions << value
     end
 
     def tool(name, &block)
@@ -38,6 +39,10 @@ module MCP
       @app.register_resource(uri, &block)
     end
 
+    def resource_template(uri_template, &block)
+      @app.register_resource_template(uri_template, &block)
+    end
+
     def run
       while (input = $stdin.gets)
         process_input(input)
@@ -56,6 +61,10 @@ module MCP
       @app.list_resources[:resources]
     end
 
+    def list_resource_templates
+      @app.list_resource_templates[:resourceTemplates]
+    end
+
     def read_resource(uri)
       @app.read_resource(uri).dig(:contents, 0, :text)
     end
@@ -172,6 +181,12 @@ module MCP
       success_response(request[:id], result)
     end
 
+    def handle_list_resources_templates(request)
+      cursor = request.dig(:params, :cursor)
+      result = @app.list_resource_templates(cursor:)
+      success_response(request[:id], result)
+    end
+
     def handle_read_resource(request)
       uri = request.dig(:params, :uri)
       result = @app.read_resource(uri)

data/lib/mcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MCP
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mcp-rb
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - funwarioisii
 bindir: bin
 cert_chain: []
-date: 2025-02-19 00:00:00.000000000 Z
+date: 2025-03-04 00:00:00.000000000 Z
 dependencies: []
 description: MCP-RB is a Ruby framework that provides a Sinatra-like DSL for implementing
   Model Context Protocol servers.
@@ -23,6 +23,7 @@ files:
 - lib/mcp.rb
 - lib/mcp/app.rb
 - lib/mcp/app/resource.rb
+- lib/mcp/app/resource_template.rb
 - lib/mcp/app/tool.rb
 - lib/mcp/client.rb
 - lib/mcp/constants.rb