active_mcp 0.9.3 → 0.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: faf657746457a11ca96f625b591bfbf82a9e2fe0f89e63629fd9402b14b414af
-  data.tar.gz: 4b457a166d61a70751546a2c30a77d4d650e4ed018f4d2e7225a9fad77a4cbaa
+  metadata.gz: b553c506022715ad2f57af006408ab14b08167505efd4aac1fc0bb08ffdde6c4
+  data.tar.gz: b6c2818a416c3da6021e04a8852e08820f757a33cba12b4ca88e7d0ad212caa5
 SHA512:
-  metadata.gz: e46fa704ad3ec0a901c506c15616f82cf54de6614fd9dba1433cdbe8948e8901c9baa540ed1b0472f76c80eb3547b676cbad9ae8de4e9f17f06a4e5b235c9eff
-  data.tar.gz: be0fc4c8a010d6be63efd0985ab256c685a1e2325b9eb1d35dd6bd84c021f0b960e6bba38dc57567b0079d346e68559930a3a5b24797b3c6fa02e42896fff7bf
+  metadata.gz: f022889f1b6dba59d4fe68586d102cd6671948e8b402e8ebcf268fa68d2a6c45b1f8cfaecc097e70499f941d9e432e8efd53c25637ce480a6b4b45f4dfb5a294
+  data.tar.gz: 5c9293d59c6d9f2f66d756baa505daaec323108b5921e761502894a54bdb008e879441ba873f0cae57b4813bdd741d50310fcce92af4656875176fbf2f2bf54d

data/README.md

@@ -38,6 +38,7 @@ A Ruby on Rails engine for the [Model Context Protocol (MCP)](https://modelconte
     - [Creating Resource Templates](#creating-resource-templates)
   - [💬 MCP Prompts](#-mcp-prompts)
     - [Creating Prompt](#creating-prompt)
+  - [📥 Using Context in the Schema](#-using-context-in-the-schema)
   - [💡 Best Practices](#-best-practices)
     - [1. Create Specific Tool Classes](#1-create-specific-tool-classes)
     - [2. Validate and Sanitize Inputs](#2-validate-and-sanitize-inputs)
@@ -95,7 +96,7 @@ $ rails generate active_mcp:tool create_note
 ```ruby
 class CreateNoteTool < ActiveMcp::Tool::Base
   def tool_name
-    "Create Note"
+    "create_note"
   end
 
   def description
@@ -117,7 +118,11 @@ end
 
 ```ruby
 class MySchema < ActiveMcp::Schema::Base
-  tool CreateNoteTool.new
+  def tools
+    [
+      CreateNoteTool.new
+    ]
+  end
 end
 ```
 
@@ -125,6 +130,9 @@ end
 
 ```ruby
 class MyMcpController < ActiveMcp::BaseController
+
+  private
+
   def schema
     MySchema.new(context:)
   end
@@ -271,7 +279,7 @@ Control access to tools by overriding the `visible?` class method:
 ```ruby
 class AdminOnlyTool < ActiveMcp::Tool::Base
   def tool_name
-    "Admin-only tool"
+    "admin_only_tool"
   end
 
   def description
@@ -380,8 +388,10 @@ end
 
 ```ruby
 class MySchema < ActiveMcp::Schema::Base
-  User.all.each do |user|
-    resource UserResource.new(id: user.id)
+  def resources
+    User.all.each do |user|
+      UserResource.new(id: user.id)
+    end
   end
 end
 ```
@@ -500,8 +510,10 @@ end
 
 ```ruby
 class MySchema < ActiveMcp::Schema::Base
-  User.all.each do |user|
-    resource UserResource.new(id: user.id)
+  def resources
+    User.all.each do |user|
+      UserResource.new(id: user.id)
+    end
   end
 end
 ```
@@ -516,33 +528,31 @@ Resources are Ruby classes `**Prompt`:
 
 ```ruby
 class HelloPrompt < ActiveMcp::Prompt::Base
-  class << self
-    def prompt_name
-      "hello"
-    end
+  argument :name, required: true, description: "User name", complete: ->(value) do
+    User.all.pluck(:name).filter { _1.match(value) }
+  end
 
-    def description
-      "This is a test."
-    end
+  def initialize(greeting:)
+    @greeting = greeting
+  end
 
-    def visible?(context:)
-      # Your logic...
-    end
+  def prompt_name
+    "hello"
   end
 
-  argument :name, ->(value) do
-    User.all.pluck(:name).filter { _1.match(value) }
+  def description
+    "This is a test."
   end
 
-  def initialize(name:)
-    @name = name
+  def visible?(context:)
+    # Your logic...
   end
 
-  def messages
+  def messages(name:)
     [
       ActiveMcp::Message::Text.new(
         role: "user",
-        text: "Hello! #{@name}"
+        text: "#{@greeting} #{name}"
       ),
       ActiveMcp::Message::Image.new(
         role: "assistant",
@@ -565,7 +575,41 @@ end
 
 ```ruby
 class MySchema < ActiveMcp::Schema::Base
-  prompt HelloPrompt
+  def prompts
+    [
+      HelloPrompt.new(greeting: "Hello!")
+    ]
+  end
+end
+```
+
+## 📥 Using Context in the Schema
+
+```ruby
+class MySchema < ActiveMcp::Schema::Base
+  def prompts
+    user = User.find_by_token(context[:auth_info][:token])
+
+    user.greetings.map do |greeting|
+      GreetingPrompt.new(greeting: greeting)
+    end
+  end
+end
+```
+
+```ruby
+class GreetingPrompt < ActiveMcp::Prompt::Base
+  def initialize(greeting:)
+    @greeting = greeting
+  end
+
+  def prompt_name
+    "greeting_#{@greeting.text}"
+  end
+
+  def messages
+    # ...
+  end
 end
 ```
 
@@ -624,7 +668,7 @@ end
 
 ## 🧪 Development
 
-After checking out the repo, run `bundle install` to install dependencies. Then, run `bundle exec rake` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bundle install` to install dependencies. Then, run `bundle exec rake` to run the tests.
 
 ## 👥 Contributing
 

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

@@ -21,11 +21,11 @@ module ActiveMcp
       when Method::CANCELLED
         render "active_mcp/cancelled", formats: :json
       when Method::RESOURCES_LIST
-        @resources = schema.resources
+        @resources = schema.visible_resources
         @format = :jsonrpc
         render "active_mcp/resources_list", formats: :json
       when Method::RESOURCES_TEMPLATES_LIST
-        @resource_templates = schema.resource_templates
+        @resource_templates = schema.visible_resource_templates
         @format = :jsonrpc
         render "active_mcp/resource_templates_list", formats: :json
       when Method::RESOURCES_READ
@@ -33,7 +33,7 @@ module ActiveMcp
         @format = :jsonrpc
         render "active_mcp/resources_read", formats: :json
       when Method::TOOLS_LIST
-        @tools = schema.tools
+        @tools = schema.visible_tools
         @format = :jsonrpc
         render "active_mcp/tools_list", formats: :json
       when Method::TOOLS_CALL
@@ -42,15 +42,15 @@ module ActiveMcp
         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 : schema.prompts)
+        @completion = ActiveMcp::Completion.new.complete(params: params[:params], context:, refs: (type === "ref/resource") ? schema.visible_resource_templates : schema.visible_prompts)
         @format = :jsonrpc
         render "active_mcp/completion_complete", formats: :json
       when Method::PROMPTS_LIST
-        @prompts = schema.prompts
+        @prompts = schema.visible_prompts
         @format = :jsonrpc
         render "active_mcp/prompts_list", formats: :json
       when Method::PROMPTS_GET
-        @prompt = schema.prompts.find { _1.prompt_name == params[:params][:name] }.new(**params[:params][:arguments].permit!.to_h.symbolize_keys)
+        @prompt = schema.visible_prompts.find { _1.prompt_name == params[:params][:name] }
         @format = :jsonrpc
         render "active_mcp/prompts_get", formats: :json
       else
@@ -62,7 +62,7 @@ module ActiveMcp
     def handle_mcp_server_request
       case params[:method]
       when Method::RESOURCES_LIST
-        @resources = schema.resources
+        @resources = schema.visible_resources
         @format = :json
         render "active_mcp/resources_list", formats: :json
       when Method::RESOURCES_READ
@@ -70,11 +70,11 @@ module ActiveMcp
         @format = :json
         render "active_mcp/resources_read", formats: :json
       when Method::RESOURCES_TEMPLATES_LIST
-        @resource_templates = schema.resource_templates
+        @resource_templates = schema.visible_resource_templates
         @format = :json
         render "active_mcp/resource_templates_list", formats: :json
       when Method::TOOLS_LIST
-        @tools = schema.tools
+        @tools = schema.visible_tools
         @format = :json
         render "active_mcp/tools_list", formats: :json
       when Method::TOOLS_CALL
@@ -83,15 +83,15 @@ module ActiveMcp
         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 : schema.prompts)
+        @completion = ActiveMcp::Completion.new.complete(params: params[:params], context:, refs: (type == "ref/resource") ? schema.visible_resource_templates : schema.visible_prompts)
         @format = :json
         render "active_mcp/completion_complete", formats: :json
       when Method::PROMPTS_LIST
-        @prompts = schema.prompts
+        @prompts = schema.visible_prompts
         @format = :json
         render "active_mcp/prompts_list", formats: :json
       when Method::PROMPTS_GET
-        @prompt = schema.prompts&.find { _1.prompt_name == params[:params][:name] }&.new(**params[:params][:arguments].permit!.to_h.symbolize_keys)
+        @prompt = schema.visible_prompts&.find { _1.prompt_name == params[:params][:name] }
         @format = :json
         render "active_mcp/prompts_get", formats: :json
       else

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

@@ -18,7 +18,7 @@ module ActiveMcp
         }
       end
 
-      resource = schema.resources.find do |r|
+      resource = schema.visible_resources.find do |r|
         r.uri == uri
       end
 

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

@@ -25,7 +25,7 @@ module ActiveMcp
         }
       end
 
-      tool = schema.tools.find do |tc|
+      tool = schema.visible_tools.find do |tc|
         tc.tool_name == tool_name
       end
 

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

@@ -2,6 +2,6 @@ json.jsonrpc ActiveMcp::JSON_RPC_VERSION if @format == :jsonrpc
 json.id @id if @format == :jsonrpc && @id.present?
 
 json.result do
-  json.description @prompt.class.description
-  json.messages @prompt.messages.map(&:to_h)
+  json.description @prompt.description
+  json.messages @prompt.messages(**params[:params][:arguments].permit!.to_h.symbolize_keys).map(&:to_h)
 end

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

@@ -6,7 +6,7 @@ json.result do
     json.array!(@prompts) do |prompt|
       json.name prompt.prompt_name
       json.description prompt.description
-      json.arguments prompt.arguments.map { _1.except(:complete) }
+      json.arguments prompt.class.arguments.map { _1.except(:complete) }
     end
   end
 end

data/lib/active_mcp/prompt/base.rb

@@ -4,7 +4,7 @@ module ActiveMcp
       class << self
         attr_reader :arguments
 
-        def argument(name, required: false, description: nil, complete: -> {})
+        def argument(name, required: false, description: "", complete: -> {})
           @arguments ||= []
 
           @arguments << {

data/lib/active_mcp/schema/base.rb

@@ -1,54 +1,34 @@
 module ActiveMcp
   module Schema
     class Base
-      class << self
-        attr_reader :resources, :resource_templates, :tools, :prompts
-
-        def resource(klass)
-          @resources ||= []
-          @resources << 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)
-          @tools ||= []
-          @tools << klass
-        end
-
-        def prompt(klass)
-          @prompts ||= []
-          @prompts << klass
-        end
-      end
+      attr_reader :context
 
       def initialize(context: {})
         @context = context
       end
 
-      def resources
-        self.class.resources&.filter do |resource|
-          !resource.respond_to?(:visible?) || resource.visible?(context: @context)
+      def visible_resources
+        resources&.filter do |resource|
+          !resource.class.respond_to?(:uri_template) && !resource.respond_to?(:visible?) || resource.visible?(context: @context)
         end
       end
 
-      def resource_templates
-        self.class.resource_templates&.filter do |template|
-          !template.respond_to?(:visible?) || template.visible?(context: @context)
+      def visible_resource_templates
+        resource_instances = resources&.filter do |resource|
+          resource.class.respond_to?(:uri_template) && (!resource.respond_to?(:visible?) || resource.visible?(context: @context))
         end
+
+        resource_instances.map(&:class)
       end
 
-      def tools
-        self.class.tools&.filter do |tool|
+      def visible_tools
+        tools&.filter do |tool|
           !tool.respond_to?(:visible?) || tool.visible?(context: @context)
         end
       end
 
-      def prompts
-        self.class.prompts&.filter do |resource|
+      def visible_prompts
+        prompts&.filter do |resource|
           !resource.respond_to?(:visible?) || resource.visible?(context: @context)
         end
       end

data/lib/active_mcp/tool/base.rb

@@ -6,7 +6,7 @@ module ActiveMcp
       class << self
         attr_reader :schema
 
-        def argument(name, type, required: false, description: nil)
+        def argument(name, type, required: false, description: "")
           @schema ||= default_schema
 
           @schema["properties"][name.to_s] = {"type" => type.to_s}

data/lib/active_mcp/version.rb

@@ -1,3 +1,3 @@
 module ActiveMcp
-  VERSION = "0.9.3"
+  VERSION = "0.10.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_mcp
 version: !ruby/object:Gem::Version
-  version: 0.9.3
+  version: 0.10.1
 platform: ruby
 authors:
 - Moeki Kawakami
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-08 00:00:00.000000000 Z
+date: 2025-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails