active_scaffold_mcp 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eff75b33a855b38a03f5b80a24ed92124bf4ffa6891a07cfac8683e2e9e7cb09
-  data.tar.gz: b8b8f6b7b6676f8fe7c6ef3ab7879135f7bfb500a675de35aa5e804636bd2049
+  metadata.gz: c59d457c311f62fe1e9ca64acb45db411b81ef9324cee89f2d144561d8468d66
+  data.tar.gz: 560aa4999ae0a8e00fefd2877b5ad0f96cd446c946faa0b3a767e6391b17bec6
 SHA512:
-  metadata.gz: 31cfd450925701dc8ceffb2ad3135e154c8b28174189d56d1a50ac3ef369d5ece315d0d6a80e01b93189deecd6088e523d900cbb782ef0b4b713c413314a6e30
-  data.tar.gz: 750b76a58cc55a2ee206d762ab67749e7e827434e5bde50c07f1ddd590e7172aec6a803f6c249e30d39b346802fe4b5e888d1aad21617337ee6cfdb655b63792
+  metadata.gz: 4326c49641a1c348eea8b952bddee0ebc3fbf1a6c269908a19d9d488ae91ced936c29bb1f95f5c7e17888b67824c9b8bf181de9b90c5bd65dc28716c47a28f03
+  data.tar.gz: dd3232549b00915f8687c90d4402a078dc43a0d9425536f2839a145a30ed27827c5622ae448836d7d4a8b34bf246e9d8d0dc1201de0931ffd3b7c0e718ef4922

data/README.md

@@ -4,6 +4,19 @@
 
 The gem is under initial development. The first implementation will provide a configuration DSL, a generated-tool registry, and read-only list and show tools.
 
+## Requirements
+
+- Ruby 3.4 or newer
+- Rails 8.1 or newer
+- Active Scaffold 4.4 or newer
+- ActionMCP 0.200 or newer
+
+Add the gem to your application:
+
+```ruby
+gem "active_scaffold_mcp", "~> 0.1.1"
+```
+
 Association columns use ActiveScaffold's list settings in MCP results. An
 unlimited collection (`associated_limit = nil`) is returned as an array. A
 positive limit returns `{records: [...], count: N}` when the complete
@@ -154,6 +167,22 @@ can override hooks such as `list_authorized?`, `beginning_of_chain`,
 `conditions_for_collection`, and named-filter security methods. Keep HTTP-only
 methods out of shared modules.
 
+List and show tools delegate their default JSON response to the protected
+`render_result` hook after records have been loaded and validated. Override it
+in an action's configured `modules` when the tool needs to emit different MCP
+content while preserving the generated action's lookup, filtering,
+authorization, and error handling:
+
+```ruby
+module AttachmentMCPResult
+  def render_result
+    render(image: encoded_attachment(@record), mime_type: @record.file.type)
+  end
+end
+
+config.mcp.expose :show, modules: AttachmentMCPResult
+```
+
 Record serialization is handled by `ActiveScaffold::MCP::Presenter`, separately
 from the ActiveScaffold action modules included by the generated tool. A custom
 presenter class may replace it for an action:
@@ -284,8 +313,7 @@ the original task runs. The class may be namespaced and must respond to `find`;
 the gem does not assume a particular user class or persistence library:
 
 ```sh
-READONLY=1 RAILS_ENV=production MCP_USER='User#123' \
-  bin/rails 'action_mcp:show_profile[primary]'
+MCP_USER='User#123' bin/rails 'action_mcp:show_profile[primary]'
 ```
 
 For a namespaced class, use a value such as
@@ -296,7 +324,7 @@ The full accepted arguments are in each tool's `inputSchema`. ActionMCP can
 print all registered schemas as JSON:
 
 ```sh
-READONLY=1 RAILS_ENV=production bin/rails action_mcp:apps:schema |
+bin/rails action_mcp:apps:schema |
   jq '.tools[] | select(.name == "list_support_tickets")'
 ```
 

data/lib/active_scaffold/mcp/list_tool.rb

@@ -29,6 +29,12 @@ module ActiveScaffold
         do_list
         return if report_disallowed_filters
 
+        render_result
+      end
+
+      protected
+
+      def render_result
         columns = mcp_output_columns
         render(text: JSON.generate(
           records: @records.map { |record| mcp_record_hash(record, columns) },

data/lib/active_scaffold/mcp/show_tool.rb

@@ -16,11 +16,17 @@ module ActiveScaffold
         return unless resolve_lookup_id
 
         do_show
-        render(text: JSON.generate(record: mcp_record_hash(@record, mcp_output_columns)))
+        render_result
       rescue ActiveRecord::RecordNotFound
         report_error("No record found for id #{params[:id].inspect}")
       end
 
+      protected
+
+      def render_result
+        render(text: JSON.generate(record: mcp_record_hash(@record, mcp_output_columns)))
+      end
+
       private
 
       def tool_authorized?

data/lib/active_scaffold/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module ActiveScaffold
   module MCP
-    VERSION = "0.1.0"
+    VERSION = "0.1.2"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_scaffold_mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Sergio Cambra
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.3'
+        version: '4.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.3'
+        version: '4.4'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement