active_mcp 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9367d905ac3b7dfa87f27063c41f24f1ed93de9d88a5fc009010ed35bfafa85
-  data.tar.gz: 7b1ed7d1f79ad9487c92a4e0595727cc60125c3584ae7029be8d3e86f9c2537b
+  metadata.gz: 664064f2b6638585937706546194313e1b9beddcec7952bde94b34b39e39f851
+  data.tar.gz: d97d6e74d9a1235fa99f7362e0c38102069705b7c6ccb8f45d292ed6f45f08f3
 SHA512:
-  metadata.gz: 5f429c060c395a06e9e146c68ea859a1750a00add2b28ba5fe3a968b20b8b335fcc3908a1f89b63aeaf24f092942af9edd4979eec2a3b380d431519ee35623d4
-  data.tar.gz: 1a0bff75ee866fbba70a5549ee867f6260cd8e925a592b9a044b3769a91ba9955487e3798647c7fa6b356e4c9cbfbd3610550a713aa4cee97dfff896c7514c15
+  metadata.gz: bd746883f2345681dafaf3ba99d1925c11eb8bf0a2ee2dc25fd17d4f1c3906b371f961a64298edc998cc58b6c1424a55efdfbbd0195c5e6e7a21dd160376821d
+  data.tar.gz: dd3ccaa91bd1f807d6f2ea7fc9dc03dc363b30b4bcad3335448f34d978c70f98d63b0ac4641455e9600639d2b88c94ca6c47cd945c8a82edecc5577b4ecbe65c

data/README.md

@@ -339,7 +339,7 @@ MCP Resources allow you to share data and files with AI assistants. Resources ha
 Resources are Ruby classes `**Resource`:
 
 ```ruby
-class UserResource
+class UserResource < ActiveMcp::Resource::Base
   def initialize(id:)
     @user = User.find(id)
     @auth_info = auth_info
@@ -401,7 +401,13 @@ end
 2. **Binary Content** - Use the `blob` method to return binary files:
 
 ```ruby
-class ImageResource
+class ImageResource < ActiveMcp::Resource::Base
+  class << self
+    def mime_type
+      "image/png"
+    end
+  end
+
   def name
     "Profile Image"
   end
@@ -410,10 +416,6 @@ class ImageResource
     "data://localhost/image"
   end
 
-  def mime_type
-    "image/png"
-  end
-
   def description
     "Profile image"
   end
@@ -446,32 +448,60 @@ MCP Resource Teamplates allow you to define template of resources.
 Resources are Ruby classes `**ResourceTemplates`:
 
 ```ruby
-class UserResourceTemplate
-  def name
-    "Users"
+class UserResource < ActiveMcp::Resource::Base
+  class << self
+    def name
+      "Users"
+    end
+
+    def uri_template
+      "data://localhost/users/{id}"
+    end
+
+    def mime_type
+      "application/json"
+    end
+
+    def description
+      "This is a test."
+    end
+
+    def visible?(context:)
+      # Your logic...
+    end
   end
 
-  def uri_template
-    "data://localhost/users/{id}"
+  argument :id, ->(value) do
+    User.all.pluck(:id).filter { _1.match(value) }
   end
 
-  def mime_type
-    "application/json"
+  def initialize(id:)
+    @user = User.find(id)
+  end
+
+  def name
+    @user.name
   end
 
   def description
-    "This is a test."
+    @user.profile
   end
 
-  def visible?(context:)
-    # Your logic...
+  def uri
+    "data://localhost/users/#{@user.name}"
+  end
+
+  def text
+    { name: @user.name }
   end
 end
 ```
 
 ```ruby
 class MySchema < ActiveMcp::Schema::Base
-  resource_template UserResourceTemplate.new
+  User.all.each do |user|
+    resource UserResource.new(id: user.id)
+  end
 end
 ```
 

data/app/controllers/concerns/active_mcp/request_handlable.rb

@@ -40,6 +40,11 @@ module ActiveMcp
         @tool_result = execute_tool(params:, context:)
         @format = :jsonrpc
         render 'active_mcp/tools_call', formats: :json
+      when Method::COMPLETION_COMPLETE
+        type = params.dig(:params, :ref, :type)
+        @completion = ActiveMcp::Completion.new.complete(params: params[:params], context:, refs: type === "ref/resource" ? schema.resource_templates : [])
+        @format = :jsonrpc
+        render "active_mcp/completion_complete", formats: :json
       else
         @format = :jsonrpc
         render 'active_mcp/no_method', formats: :json
@@ -68,6 +73,11 @@ module ActiveMcp
         @tool_result = execute_tool(params:, context:)
         @format = :json
         render 'active_mcp/tools_call', formats: :json
+      when Method::COMPLETION_COMPLETE
+        type = params.dig(:params, :ref, :type)
+        @completion = ActiveMcp::Completion.new.complete(params: params[:params], context:, refs: type == "ref/resource" ? schema.resource_templates : [])
+        @format = :json
+        render "active_mcp/completion_complete", formats: :json
       else
         @format = :json
         render 'active_mcp/no_method', formats: :json

data/app/controllers/concerns/active_mcp/resource_readable.rb

@@ -42,7 +42,7 @@ module ActiveMcp
             contents: [
               {
                 uri:,
-                mimeType: resource.mime_type,
+                mimeType: resource.class.mime_type,
                 text: formatted(content)
               }
             ]
@@ -52,7 +52,7 @@ module ActiveMcp
             contents: [
               {
                 uri:,
-                mimeType: resource.mime_type,
+                mimeType: resource.class.mime_type,
                 blob: Base64.strict_encode64(content)
               }
             ]

data/app/views/active_mcp/completion_complete.json.jbuilder

@@ -0,0 +1,16 @@
+json.jsonrpc ActiveMcp::JSON_RPC_VERSION if @format == :jsonrpc
+json.id @id if @format == :jsonrpc && @id.present?
+
+if @format == :jsonrpc
+  json.result do
+    json.completion do
+      json.values @completion[:values]
+      json.total @completion[:total]
+    end
+  end
+else
+  json.result do
+    json.values @completion[:values]
+    json.total @completion[:total]
+  end
+end

data/app/views/active_mcp/resources_list.json.jbuilder

@@ -7,7 +7,7 @@ if @format == :jsonrpc
       json.array!(@resources) do |resource|
         json.name resource.name
         json.uri resource.uri
-        json.mimeType resource.mime_type
+        json.mimeType resource.class.mime_type
         json.description resource.description
       end
     end
@@ -17,7 +17,7 @@ else
     json.array!(@resources) do |resource|
       json.name resource.name
       json.uri resource.uri
-      json.mimeType resource.mime_type
+      json.mimeType resource.class.mime_type
       json.description resource.description
     end
   end

data/lib/active_mcp/completion.rb

@@ -0,0 +1,18 @@
+module ActiveMcp
+  class Completion
+    def complete(params: {}, context: {}, refs: [])
+      ref_name = params.dig(:ref, :name)
+      uri_template = params.dig(:ref, :uri)
+      arg_name = params.dig(:argument, :name)
+      value = params.dig(:argument, :value)
+
+      if uri_template
+        resource_class = refs.find { _1.uri_template == uri_template }
+        values = resource_class.arguments[arg_name.to_sym].call(value)
+        { values:, total: values.length }
+      elsif ref_name
+        { values: [], total: 0 }
+      end
+    end
+  end
+end

data/lib/active_mcp/resource/base.rb

@@ -0,0 +1,29 @@
+require "json-schema"
+
+module ActiveMcp
+  module Resource
+    class Base
+      class << self
+        attr_reader :schema, :arguments
+
+        def argument(name, complete)
+          @arguments = {}
+          @arguments[name] = complete
+        end
+      end
+
+      def initialize
+      end
+
+      def name
+      end
+
+      def description
+      end
+
+      def visible?(context: {})
+        true
+      end
+    end
+  end
+end

data/lib/active_mcp/schema/base.rb

@@ -7,11 +7,11 @@ module ActiveMcp
         def resource(klass)
           @resources ||= []
           @resources << klass
-        end
 
-        def resource_template(klass)
-          @resource_templates ||= []
-          @resource_templates << klass
+          if klass.class.respond_to?(:uri_template)
+            @resource_templates ||= []
+            @resource_templates << klass.class unless klass.class.in?(@resource_templates)
+          end
         end
 
         def tool(klass)
@@ -31,8 +31,8 @@ module ActiveMcp
       end
 
       def resource_templates
-        self.class.resource_templates.filter do |tool_resource|
-          !tool_resource.respond_to?(:visible?) || tool_resource.visible?(context: @context)
+        self.class.resource_templates.filter do |template|
+          !template.respond_to?(:visible?) || template.visible?(context: @context)
         end
       end
 

data/lib/active_mcp/server/method.rb

@@ -11,5 +11,6 @@ module ActiveMcp
     RESOURCES_LIST = "resources/list"
     RESOURCES_READ = "resources/read"
     RESOURCES_TEMPLATES_LIST = "resources/templates/list"
+    COMPLETION_COMPLETE = "completion/complete"
   end
 end

data/lib/active_mcp/server/protocol_handler.rb

@@ -58,6 +58,8 @@ module ActiveMcp
           handle_call_tool(request)
         when Method::RESOURCES_READ
           handle_read_resource(request)
+        when Method::COMPLETION_COMPLETE
+          handle_complete(request)
         else
           error_response(request[:id], ErrorCode::METHOD_NOT_FOUND, "Unknown method: #{request[:method]}")
         end
@@ -194,6 +196,21 @@ module ActiveMcp
         end
       end
 
+      def handle_complete(request)
+        begin
+          result = @server.fetch(
+            params: {
+              method: Method::COMPLETION_COMPLETE,
+              params: request[:params],
+            }
+          )
+          success_response(request[:id], { completion: result[:result] })
+        rescue => e
+          Server.("Error reading resource #{uri}", e)
+          error_response(request[:id], ErrorCode::INTERNAL_ERROR, "An error occurred while reading the resource")
+        end
+      end
+
       def success_response(id, result)
         {
           jsonrpc: JSON_RPC_VERSION,

data/lib/active_mcp/version.rb

@@ -1,3 +1,3 @@
 module ActiveMcp
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

data/lib/active_mcp.rb

@@ -5,7 +5,9 @@ require_relative "active_mcp/version"
 require_relative "active_mcp/configuration"
 require_relative "active_mcp/schema/base"
 require_relative "active_mcp/tool/base"
+require_relative "active_mcp/resource/base"
 require_relative "active_mcp/server"
+require_relative "active_mcp/completion"
 
 if defined? ::Rails
   require_relative "active_mcp/engine"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: active_mcp
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Moeki Kawakami
 bindir: exe
 cert_chain: []
-date: 2025-04-07 00:00:00.000000000 Z
+date: 2025-04-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -73,6 +73,7 @@ files:
 - app/controllers/concerns/active_mcp/resource_readable.rb
 - app/controllers/concerns/active_mcp/tool_executable.rb
 - app/views/active_mcp/cancelled.json.jbuilder
+- app/views/active_mcp/completion_complete.json.jbuilder
 - app/views/active_mcp/initialize.json.jbuilder
 - app/views/active_mcp/initialized.json.jbuilder
 - app/views/active_mcp/no_method.json.jbuilder
@@ -83,9 +84,11 @@ files:
 - app/views/active_mcp/tools_list.json.jbuilder
 - config/routes.rb
 - lib/active_mcp.rb
+- lib/active_mcp/completion.rb
 - lib/active_mcp/configuration.rb
 - lib/active_mcp/controller/base.rb
 - lib/active_mcp/engine.rb
+- lib/active_mcp/resource/base.rb
 - lib/active_mcp/schema/base.rb
 - lib/active_mcp/server.rb
 - lib/active_mcp/server/error_codes.rb