mcp_on_ruby 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 611ceb54904a193a5ac06d7fc7d223d835067a3d2232b05fc8a46dd1b14b96ac
-  data.tar.gz: 8d368c37165bf816104cb32345f7576b95e6e36ff5a01e3b2ecf7a07e497172a
+  metadata.gz: ac6effb14117c29ebe4aab9f0178aa7ded445b448c80f7438956cbfc088c1934
+  data.tar.gz: 052b0c6053db07aee0ebe0991949bae91ec268d9911b5512527b54fb2fb7c503
 SHA512:
-  metadata.gz: 1c0528601bea68540a356a143abc104267e3b3bd8972c38544f13d0a1dd49696ab2d62d571ca6f51a9bdc0b5088e8f0eac4bebd18cef307759babfeaadc1e4d0
-  data.tar.gz: 183338a617d68e0e7fd963d627439e62cfdf66045f80f621b778cd12294ab34bf015f2ccf813ca3b747ce74c7bf1ef01e193e785423f6e94e4fac2e8b7918804
+  metadata.gz: deafb7ff0545ab491e495fba46d21d27ff66e9c397d7466c1800b74206c98aa19569855148f4b0015e9cd5ce3a78bdc29b591a7599ca95b2afdf97d191b54054
+  data.tar.gz: 5da7f45bc3087d683a1f17283709f14b3e020b8f69ab270fa00156953abec498593e843c01278644ee57bf08fca227e2df1a9745ea9e747cb9b79974e1727a9e

data/CHANGELOG.md

@@ -2,12 +2,18 @@
 
 All notable changes to this project are documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Entries from 2.0.0 onward
+are generated by [release-please](https://github.com/googleapis/release-please) from Conventional Commit PR titles.
 
-## [Unreleased]
+## [2.0.1](https://github.com/nagstler/mcp_on_ruby/compare/v2.0.0...v2.0.1) (2026-10-31)
 
-## [2.0.0] - 2026-10-31
+
+### Bug Fixes
+
+* reuse tool classes when writes are disabled ([#33](https://github.com/nagstler/mcp_on_ruby/issues/33)) ([44be48c](https://github.com/nagstler/mcp_on_ruby/commit/44be48cafcb508a559b718f676e27990277bd41b))
+* validate declarations once routes are loaded ([#32](https://github.com/nagstler/mcp_on_ruby/issues/32)) ([bf96834](https://github.com/nagstler/mcp_on_ruby/commit/bf968346f9131c6f898bdcf152726973079f3429))
+
+## [2.0.0](https://github.com/nagstler/mcp_on_ruby/compare/v1.0.0...v2.0.0) (2026-10-31)
 
 MCP on Ruby is now a Rails engine that exposes existing controller actions as MCP tools,
 built on the official [`mcp`](https://github.com/modelcontextprotocol/ruby-sdk) gem.
@@ -99,7 +105,3 @@ built on the official [`mcp`](https://github.com/modelcontextprotocol/ruby-sdk)
 - Resource management
 - Prompt handling
 - Root filesystem access
-
-[Unreleased]: https://github.com/nagstler/mcp_on_ruby/compare/v2.0.0...HEAD
-[2.0.0]: https://github.com/nagstler/mcp_on_ruby/compare/v1.0.0...v2.0.0
-[1.0.0]: https://github.com/nagstler/mcp_on_ruby/releases/tag/v1.0.0

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024
+Copyright (c) 2024-present Nagendra Dhanakeerthi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -107,21 +107,12 @@ Then ask: *"Which of my products cost more than $50?"*
 
 ## How it works
 
-```
- MCP client (Claude, Cursor, …)
-        │  Streamable HTTP (/mcp)   or   stdio (bin/rails mcp:stdio)
-        ▼
- official mcp gem ──────── protocol, version negotiation, schema validation
-        │  tools/call  orders_index  { "status": "pending" }
-        ▼
- MCP on Ruby
-   Registry    which controller actions are exposed, with their routes and schemas
-   Dispatcher  builds an in-process request:  GET /orders?status=pending
-   Identity    the caller's Authorization header and cookies, or the stdio user
-   Result      2xx JSON → structured result; 4xx/5xx → readable tool error
-        ▼
- Your Rails app: middleware → routes → before_action → controller → render json
-```
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/how-it-works-dark.svg">
+    <img src="docs/assets/how-it-works.svg" width="960" alt="An MCP client sends a tool call over HTTP or stdio to the official mcp gem, which hands it to MCP on Ruby. MCP on Ruby runs it as an ordinary Rails request through your app, as the caller, and the JSON response comes back as the tool result.">
+  </picture>
+</p>
 
 Each tool call becomes an ordinary request through your full middleware stack. Anything that protects your API, including `rate_limit`, Rack::Attack, tenant scoping, and audit logging, protects agent traffic too.
 
@@ -396,7 +387,7 @@ end
 
 | | Supported |
 |---|---|
-| Ruby | 3.2, 3.3, 3.4 |
+| Ruby | 3.2, 3.3, 3.4, 4.0 |
 | Rails | 7.1, 7.2, 8.0, 8.1 |
 | MCP protocol | Every version the official `mcp` gem supports, negotiated per client |
 | Transports | Streamable HTTP (stateless), stdio |

data/lib/mcp_on_ruby/engine.rb

@@ -20,10 +20,15 @@ module McpOnRuby
       McpOnRuby.registry.reset!
     end
 
-    # Fail at boot, not on the first agent request, when declarations do not match routes.
-    config.after_initialize do |app|
+    config.after_initialize do
       McpOnRuby::WardenHook.install!
-      McpOnRuby.registry.tools if app.config.eager_load
+    end
+
+    # Fail at boot, not on the first agent request, when declarations do not match routes.
+    # Rails runs after_initialize before it loads routes, so validate once routes are loaded,
+    # which happens during boot (after eager loading) when eager_load is on.
+    initializer "mcp_on_ruby.validate_declarations" do |app|
+      app.config.after_routes_loaded { McpOnRuby.registry.tools } if app.config.eager_load
     end
   end
 end

data/lib/mcp_on_ruby/server_factory.rb

@@ -45,12 +45,16 @@ module McpOnRuby
       @dispatcher ||= Dispatcher.new
     end
 
-    # Tool classes are rebuilt only when the registry is (on boot and code reload).
+    # Tool classes are rebuilt only when the registry is (on boot and code reload) or when
+    # `allow_writes` changes, never per request.
     def mcp_tools
-      specs = served_specs
+      key = [registry.tools, configuration.allow_writes]
       @mutex.synchronize do
-        @cache = [specs, specs.map { |spec| spec.to_mcp_tool(handler) }] unless @cache&.first.equal?(specs)
-        @cache.last
+        unless @cache && @cache[:registry].equal?(key.first) && @cache[:allow_writes] == key.last
+          @cache = { registry: key.first, allow_writes: key.last,
+                     tools: served_specs.map { |spec| spec.to_mcp_tool(handler) } }
+        end
+        @cache[:tools]
       end
     end
 

data/lib/mcp_on_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module McpOnRuby
-  VERSION = "2.0.0"
+  VERSION = "2.0.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mcp_on_ruby
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Nagendra Dhanakeerthi