rails_mcp_engine 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3448e618eae50c7f5357c7948986b5208a308f685d5bb88e311790e4a3467825
-  data.tar.gz: 0ca92186f069f550157bf15dfb8df68e954cd14db58688af06af981cacf65d1b
+  metadata.gz: 4fbb05874281e54c77a8c73b712a7961f0f4fa70c052602334eaee0a90512ecb
+  data.tar.gz: ea63d1877987cfabe4ed411ba71e101f188f373566a65ced6e484234a17a8892
 SHA512:
-  metadata.gz: ffe2fddbaf4dce4ae4e93f38ae5200de091558849f779ff93a4d2f4237a81789717b8945f73f9def02ba0972971cac76516cbdd21ddc3201456acedd825e8751
-  data.tar.gz: 92b5d6c89ec0ed02fc3b1bfbda1dff9b643d2abcdf81900802937d3755a3d3f2c9ae0c5b44d2c9bf980d21c1246976ca1e01e36fd5952449ff8ff540d4085f83
+  metadata.gz: afd050e10d5ff10fe4aa6b4beb57ef19169be804714d61ccb361fa1e6c793726a260c7da6886dc0726bb9f5c5296159d56cbad8cefbb68f41768b0411b9a2529
+  data.tar.gz: 815636ce20fab4d2d94fc7f65afa2b5fb4c4675fd0bc6758617bbb1b54696cd62f6707549862508a5bd32cf59971b9d9fe099f5b6789fe321857ef4b6a0ef1c8

data/README.md

@@ -6,7 +6,7 @@ Rails MCP Engine provides a unified tool-definition pipeline for Rails 8 applica
 
 This engine is built on top of these powerful libraries:
 
-- **[RubyLLM](https://github.com/crmne/ruby_llm)**: For generating LLM-compatible tool definitions.
+- **[RubyLLM](https://github.com/crmne/ruby_llm)**: For generating LLM-compatible tool definitions. Supports versions `>= 1.9, < 3` (1.x and 2.x).
 - **[FastMCP](https://github.com/yjacquin/fast-mcp)**: For creating Model Context Protocol (MCP) servers.
 - **[Sorbet](https://github.com/sorbet/sorbet)**: For static type checking and signature definitions.
 
@@ -61,7 +61,7 @@ end
 ```
 
 On boot, the engine generates:
-- `Tools::BookMeeting < RubyLLM::Tool` with a matching `params` block.
+- `Tools::BookMeeting < RubyLLM::Tool` with a matching `params` block on RubyLLM 1.x or `parameters` block on 2.x.
 - `Mcp::BookMeetingTool < ApplicationTool` with a matching `arguments` block.
 
 ## Default meta tool
@@ -108,11 +108,8 @@ You can easily fetch the generated RubyLLM tool classes for use in your host app
 tool_classes = Tools::MetaToolService.ruby_llm_tools(['book_meeting', 'calculator'])
 
 # Use them with RubyLLM
-response = RubyLLM.chat(
-  messages: messages,
-  tools: tool_classes,
-  model: 'gpt-4o'
-)
+chat = RubyLLM.chat(model: 'gpt-4o').with_tools(*tool_classes)
+response = chat.ask('Book a meeting with the team.')
 ```
 
 
@@ -120,7 +117,25 @@ response = RubyLLM.chat(
 
 After checking out the repo, run `bundle install` to install dependencies. Then, run `bundle exec rails test` to run the tests.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+### Gem release
+
+`ruby script/release.rb` adapts [Collavre's release script](https://github.com/sh1nj1/plan42/blob/main/script/release.rb) for this single gem repository.
+
+Run it from a clean `main` checkout with Ruby 3.2+, Bundler, Git push access, and RubyGems credentials (`gem signin`, including MFA when prompted). It pulls `main` with fast-forward only, shows commits since the last version change, and prompts for a higher `MAJOR.MINOR.PATCH` version (default: next patch).
+
+To use a known release commit instead of the last version-file change:
+
+```sh
+ruby script/release.rb --last-release-commit <SHA>
+```
+
+The full or abbreviated commit SHA must exist locally and be an ancestor of the updated `HEAD`. Changes after that commit (excluding the commit itself) are shown and used in release notes. Invalid, ambiguous, or unrelated commits stop the script before version input or file changes. Omit the option to keep the existing last-version-change behavior. Use `--help` to see available options.
+
+The script creates a release branch, updates the version, `RELEASE_NOTES.md`, and lockfile, runs Rails unit and system tests, commits those files, builds into `build/gems`, and publishes to RubyGems. It then fast-forwards `main`, pushes it, and pushes only the new `vVERSION` tag. System tests require Chrome/Chromium, as in CI.
+
+Dependency or test failures restore the original files and return to `main`, keeping the release branch for diagnosis. Failures after the commit leave the commit and build available. If upload fails, retry the printed `gem push` command; after a successful upload, finish the Git steps manually if necessary. RubyGems publication cannot be undone by Git rollback; do not rerun the whole script after a successful upload.
+
+To install this gem onto your local machine, run `bundle exec rake install`. Use `ruby script/release.rb` for releases as described above.
 
 ### Playground & Chat
 

data/app/controllers/rails_mcp_engine/chat_controller.rb

@@ -42,14 +42,11 @@ module RailsMcpEngine
                  end
 
       # Create RubyLLM chat instance with configuration
-      chat = RubyLLM.chat(
-        provider: provider,
-        model: model
-      )
+      chat = build_chat(model, provider)
 
       # Register all available tools
       tool_classes = get_tool_classes
-      chat = tool_classes.reduce(chat) { |c, tool_class| c.with_tool(tool_class) }
+      chat = tool_classes.reduce(chat) { |c, tool_class| c.with_tools(tool_class) }
 
       # Prepare the message with conversation history context
       if conversation_history.empty?
@@ -94,6 +91,14 @@ module RailsMcpEngine
 
     private
 
+    def build_chat(model, provider)
+      options = { model: model, provider: provider }
+      if provider == :openai && defined?(RubyLLM::Protocols::ChatCompletions)
+        options[:protocol] = :chat_completions
+      end
+      RubyLLM.chat(**options)
+    end
+
     def schemas
       ToolMeta.registry.map { |service_class| ToolSchema::Builder.build(service_class) }
     end

data/app/lib/tool_schema/ruby_llm_factory.rb

@@ -21,9 +21,15 @@ module ToolSchema
       parent = Tools
       parent.send(:remove_const, tool_constant) if parent.const_defined?(tool_constant, false)
 
+      tool_name = T.let(schema[:name], String)
       klass = Class.new(RubyLLM::Tool) do
         description(schema[:description])
-        params(&RubyLlmBuilder.params_block(schema[:params]))
+        public_send(RubyLLM::Tool.respond_to?(:params) ? :params : :parameters,
+                    &RubyLlmBuilder.params_block(schema[:params]))
+
+        # Override RubyLLM::Tool#name to use the tool_name from ToolMeta
+        # instead of the auto-generated name from the Ruby class name.
+        define_method(:name) { tool_name }
 
         define_method(:execute) do |**kwargs|
           before_call&.call(kwargs)

data/lib/rails_mcp_engine/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module RailsMcpEngine
-  VERSION = '0.4.1'
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_mcp_engine
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Soonoh Jung
@@ -47,16 +47,22 @@ dependencies:
   name: ruby_llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.9'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.9'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: sorbet-runtime
   requirement: !ruby/object:Gem::Requirement