actionmcp 0.50.10 → 0.50.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d09ebd13460c234fc23c4c509ffec0b9cb48ea6607108217be7309aee8dbf617
-  data.tar.gz: b269226676ee4974b7757093e721cca942eb7acb60e47fa72b6999b780a7bf7f
+  metadata.gz: a500e24390bf32c0e74cba14755f67257c91b69ba6ffe786e3b692efd82c87cc
+  data.tar.gz: d122b12b45799b719f077d742a1a5edd85eac4cbe96e2a85259eb7673c858f36
 SHA512:
-  metadata.gz: e6300709a72e3d8c54d23c4c2ba23bd751c2bac1b5c25f7b7ba5a8ff6d60f455571ef4b1a8e212b2cb22d05b3e06b803926d5b39d2daf9446b38d6296ea3277a
-  data.tar.gz: a2385c3f8910c27b8b36ce7d8cef73d6cf6db18922c0b6d9a7f51abd43d5a06a35f04e715cbfe32b1dbf7c8793a72f4d94b0142553d94e4360b9b1e5825164f9
+  metadata.gz: f7878f2188781097208e5a703cdd6b3c6fcffa6cea0fef3db5e13538499bae935eebfc3ec6ffbbb77267f016023abe2c9b1e476b51b1d87910c81d4f44c5f4b7
+  data.tar.gz: 72048e1f3c8d3062bbc17840c14d5abfbc04fe620710d5dde9d3f98ce44a866347b95884fa03fb402d2d2cab078d7f9d6e9eb49690d338f29484b64fcad3caa5

data/lib/action_mcp/tool.rb

@@ -52,12 +52,28 @@ module ActionMCP
       end
 
       # Convenience methods for common annotations
+      def title(value = nil)
+        if value
+          annotate(:title, value)
+        else
+          _annotations["title"]
+        end
+      end
+
       def destructive(enabled = true)
-        annotate(:destructive, enabled)
+        annotate(:destructiveHint, enabled)
       end
 
       def read_only(enabled = true)
-        annotate(:readOnly, enabled)
+        annotate(:readOnlyHint, enabled)
+      end
+
+      def idempotent(enabled = true)
+        annotate(:idempotentHint, enabled)
+      end
+
+      def open_world(enabled = true)
+        annotate(:openWorldHint, enabled)
       end
 
       # Return annotations for the tool

data/lib/action_mcp/version.rb

@@ -2,7 +2,7 @@
 
 require_relative "gem_version"
 module ActionMCP
-  VERSION = "0.50.10"
+  VERSION = "0.50.11"
 
   class << self
     alias version gem_version

data/lib/generators/action_mcp/prompt/templates/prompt.rb.erb

@@ -6,16 +6,20 @@ class <%= class_name %> < ApplicationMCPPrompt
   prompt_name "<%= prompt_name %>"
 
   # Provide a user-facing description for your prompt.
-  description "Analyze code for potential improvements"
+  description "<%= description || 'Describe what this prompt does' %>"
 
-  # Configure arguments via the new DSL
-  argument :language, description: "Programming language", default: "Ruby"
-  argument :code, description: "Code to explain", required: true
+  # Configure arguments (example structure — override as needed)
+  argument :input, description: "Main input", required: true
 
-  # Add validations (note: "Ruby" is not allowed per the validation)
-  validates :language, inclusion: { in: %w[Ruby C Cobol FORTRAN] }
+  # Optional: add more arguments if needed
+  # argument :context, description: "Context for the input", default: ""
 
-  # Implement your prompt's behavior here
-  def call
+  # Optional: validations can be added as needed
+  # validates :input, presence: true
+  # validates :context, length: { maximum: 500 }
+
+  # Main logic for prompt
+  def perform
+    # Implement behavior here
   end
 end

data/lib/generators/action_mcp/tool/templates/tool.rb.erb

@@ -1,17 +1,46 @@
 # frozen_string_literal: true
 
-# Template for generating new tools.
 class <%= class_name %> < ApplicationMCPTool
-  # Set the tool name.
   tool_name "<%= tool_name %>"
-  description "Calculate the sum of two numbers"
+  description "<%= description %>"
+<% if options[:title] %>
+  title "<%= options[:title] %>"
+<% end %>
+<% if options[:read_only] %>
+  read_only
+<% end %>
+<% if options[:destructive] %>
+  destructive
+<% end %>
+<% if options[:idempotent] %>
+  idempotent
+<% end %>
+<% if options[:open_world] %>
+  open_world
+<% end %>
+<% annotations.each do |k, v| %>
+  <% unless [:read_only, :destructive, :idempotent, :open_world, :title].include?(k) %>
+  annotate(:<%= k %>, <%= v.inspect %>)
+  <% end %>
+<% end %>
 
-  # Define input properties.
-  property :a, type: "number", description: "First number", required: true
-  property :b, type: "number", description: "Second number", required: true
+    <% if properties.empty? %>
+  property :input, type: "string", description: "Input", required: true
+    <% else %>
+    <% properties.each do |prop| %>
+  property :<%= prop[:name] %>, type: "<%= prop[:type] %>", description: "<%= prop[:description] %>"<%= ", required: true" if prop[:required] %>
+    <% end %>
+    <% end %>
 
-  # Implement the tool's logic here.
-  def call
-    render(text: a + b)
+  def perform
+    render(text: "Processing <%= properties.map { |p| p[:name] }.join(', ') %>")
+
+    # Optional outputs:
+    # render(audio: "<base64_data>", mime_type: "audio/mpeg")
+    # render(image: "<base64_data>", mime_type: "image/png")
+    # render(resource: "file://path", mime_type: "application/json", text: "{}")
+    # render(resource: "file://path", mime_type: "application/octet-stream", blob: "<base64_data>")
+  rescue => e
+    render(error: ["Error: #{e.message}"])
   end
 end

data/lib/generators/action_mcp/tool/tool_generator.rb

@@ -7,32 +7,58 @@ module ActionMCP
       source_root File.expand_path("templates", __dir__)
       desc "Creates a Tool (in app/mcp/tools) that inherits from ApplicationMCPTool"
 
-      # The generator takes one argument, e.g. "CalculateSum"
       argument :name, type: :string, required: true, banner: "ToolName"
 
+      class_option :description, type: :string, default: "Describe what this tool does"
+      class_option :read_only, type: :boolean, default: false
+      class_option :destructive, type: :boolean, default: false
+      class_option :category, type: :string, default: nil
+      class_option :properties, type: :array, default: [], banner: "name:type:description:required"
+
       def create_tool_file
         template "tool.rb.erb", "app/mcp/tools/#{file_name}.rb"
       end
 
       private
 
-      # Compute the class name ensuring it ends with "Tool"
       def class_name
         "#{name.camelize}#{name.camelize.end_with?('Tool') ? '' : 'Tool'}"
       end
 
-      # Compute the file name ensuring it ends with _tool.rb
       def file_name
         base = name.underscore
         base.end_with?("_tool") ? base : "#{base}_tool"
       end
 
-      # Compute the DSL tool name (a dashed version, without the "Tool" suffix)
       def tool_name
         base = name.to_s
-        base = base[0...-4] if base.end_with?("Tool")
+        base = base.end_with?("Tool") ? base[0..-5] : base
         base.underscore.dasherize
       end
+
+      def description
+        options[:description]
+      end
+
+      def annotations
+        ann = {}
+        ann[:read_only] = true if options[:read_only]
+        ann[:destructive] = true if options[:destructive]
+        ann[:category] = options[:category] if options[:category]
+        ann
+      end
+
+      def properties
+        options[:properties].map do |prop|
+          parts = prop.split(":")
+          {
+            name: parts[0],
+            type: parts[1] || "string",
+            description: parts[2] || "No description provided",
+            required: parts[3] == "true"
+          }
+        end
+      end
     end
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: actionmcp
 version: !ruby/object:Gem::Version
-  version: 0.50.10
+  version: 0.50.11
 platform: ruby
 authors:
 - Abdelkader Boudih
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -220,7 +219,6 @@ metadata:
   source_code_uri: https://github.com/seuros/action_mcp
   changelog_uri: https://github.com/seuros/action_mcp/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -235,8 +233,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Provides essential tooling for building Model Context Protocol (MCP) capable
   servers