rails-mcp-server 1.4.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25c3767eb1c84eb4ac69450ab2118659b7b8eeca87722bfb3456be06543182b6
-  data.tar.gz: e0c62dcc4abba55695290ba082007f0ea6b5bd19dae7bf257f51f4d426a51de5
+  metadata.gz: 65769f824f1dbb5bfe856a40f0a46aed59d4591b3e2d23c486b6f6a08687075c
+  data.tar.gz: 596d5a5bd1d22559a0d4d9ea1369b1c375546ce790a3c71edc378c053c75b433
 SHA512:
-  metadata.gz: 0677e15106d3574a9f061022aa4f37977a1d3e79166d54b59293127ae84f806d8f4f19d03384924072b455c1787bb68016d8cdc486ca6e5a0f7822848766403b
-  data.tar.gz: d13b1175daf7fc56b1d245994d2ed741d33fd6f073acabbd899a89cd3608d23782c5fe9e671716087ae81b52b33090791dc8fcc0a1aab68432442cc434e02148
+  metadata.gz: 4c51f927f27949ec313ce1762911676f338553513189f030fc610847ced95d0b1f31d8badcfafe6d89d077e15fde6b6ec2d4e9a4417afd2aaeccd3275b46c170
+  data.tar.gz: 5d290f823f45a04ef7a4e0fed4a2ec2820e6be1c086af40441dc33cba7423ac2698e58b300febe2f8cd7accbdf49e7f5663dbd38f2e4a8162d6c30b326849cc2

data/CHANGELOG.md

@@ -5,6 +5,67 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.1] - 2025-12-11
+
+### Fixed
+
+- **rails-mcp-config rbenv compatibility**: Fixed silent failure when running via rbenv shims
+  - The `__FILE__ == $0` guard failed because RubyGems' `load` creates a path mismatch between `__FILE__` (gem path) and `$0` (shim path)
+  - Now correctly detects execution via `File.basename($0) == "rails-mcp-config"`
+
+## [1.4.0] - 2025-12-10
+
+### Added
+
+- **Context-Efficient Architecture**: Reduced registered MCP tools from 12 to 4, cutting initial context consumption by 67%
+  - 4 bootstrap tools: `switch_project`, `search_tools`, `execute_tool`, `execute_ruby`
+  - 9 internal analyzers invoked via `execute_tool` meta-dispatcher
+  - Tools are now discovered on-demand rather than loaded upfront
+- **Sandboxed Ruby Execution** (`execute_ruby`): Secure code execution in Rails context
+  - File/network/system call restrictions
+  - Sensitive file protection (.env, credentials, .gitignore'd files)
+  - Helper methods: `read_file`, `file_exists?`, `list_files`, `project_root`
+- **Interactive Configuration Tool** (`rails-mcp-config`): New TUI for project management
+  - Project management with validation
+  - Guide downloading with progress indicators
+  - Claude Desktop auto-configuration (STDIO/HTTP modes)
+  - Gum-enhanced UI with terminal fallback
+- **Claude Code Integration**: Added CLAUDE.md, .claudeignore, and .claude/ configuration
+- **Agent Documentation**: New docs/AGENT.md comprehensive AI agent guide
+
+### Changed
+
+- **Architecture Refactor**: Separation of tools/ (FastMCP) vs analyzers/ (plain Ruby classes)
+  - New `lib/rails-mcp-server/analyzers/` directory with `RailsMcpServer::Analyzers` namespace
+  - Removed deprecated extensions (resource_templating, server_templating)
+- **Rails Introspection** (replaces regex parsing):
+  - `Model.reflect_on_all_associations` for accurate association data
+  - `Model.validators` with conditions and options
+  - `Controller.action_methods` instead of scanning for `def`
+  - `Rails.application.routes.routes` for direct route access
+  - `_process_action_callbacks` for before/after actions
+- **Prism Static Analysis**: AST-based code inspection for callbacks, scopes, concerns
+  - Method definitions with line numbers
+  - Instance variables per controller action
+  - New `analysis_type` parameter: introspection | static | full
+
+### Improved
+
+- **Output Optimization**: New `detail_level` parameter (names | summary | full)
+- **Route Filtering**: Filter by controller, verb, or path
+- **Batch Operations**: Support for analyzing multiple models and schemas at once
+- **Quick Start Guide**: Shown after `switch_project` for better onboarding
+- **execute_ruby Hints**: Improved feedback for missing puts statements
+
+### Fixed
+
+- **get_routes**: Fixed method definition order bug
+
+### Technical
+
+- Test suite with 32 tests covering analyzers and tools
+- Test fixtures with sample Rails project structure
+
 ## [1.2.3] - 2025-12-10
 
 ### Fixed
@@ -201,6 +262,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version History Summary
 
+- **v1.4.0** (2025-12-10): Context-efficient architecture with progressive tool discovery (67% token reduction)
 - **v1.2.3** (2025-12-10): Setup script fix for readonly filesystems (NixOS compatibility)
 - **v1.2.2** (2025-07-21): Network access support with --bind-all flag
 - **v1.2.1** (2025-06-09): Bug fixes for STDIO output and tool naming

data/exe/rails-mcp-config

@@ -19,44 +19,44 @@ module RailsMcpConfig
     end
 
     # Catppuccin Mocha palette
-    def self.green(text)    = rgb(166, 227, 161, text)  # #a6e3a1
-    def self.red(text)      = rgb(243, 139, 168, text)  # #f38ba8
-    def self.yellow(text)   = rgb(249, 226, 175, text)  # #f9e2af
-    def self.blue(text)     = rgb(137, 180, 250, text)  # #89b4fa
-    def self.mauve(text)    = rgb(203, 166, 247, text)  # #cba6f7
-    def self.teal(text)     = rgb(148, 226, 213, text)  # #94e2d5
-    def self.peach(text)    = rgb(250, 179, 135, text)  # #fab387
-    def self.pink(text)     = rgb(245, 194, 231, text)  # #f5c2e7
-    def self.sky(text)      = rgb(137, 220, 235, text)  # #89dceb
+    def self.green(text) = rgb(166, 227, 161, text)  # #a6e3a1
+    def self.red(text) = rgb(243, 139, 168, text)  # #f38ba8
+    def self.yellow(text) = rgb(249, 226, 175, text)  # #f9e2af
+    def self.blue(text) = rgb(137, 180, 250, text)  # #89b4fa
+    def self.mauve(text) = rgb(203, 166, 247, text)  # #cba6f7
+    def self.teal(text) = rgb(148, 226, 213, text)  # #94e2d5
+    def self.peach(text) = rgb(250, 179, 135, text)  # #fab387
+    def self.pink(text) = rgb(245, 194, 231, text)  # #f5c2e7
+    def self.sky(text) = rgb(137, 220, 235, text)  # #89dceb
     def self.lavender(text) = rgb(180, 190, 254, text)  # #b4befe
-    def self.text(text)     = rgb(205, 214, 244, text)  # #cdd6f4
-    def self.subtext(text)  = rgb(166, 173, 200, text)  # #a6adc8
-    def self.overlay(text)  = rgb(108, 112, 134, text)  # #6c7086
+    def self.text(text) = rgb(205, 214, 244, text)  # #cdd6f4
+    def self.subtext(text) = rgb(166, 173, 200, text)  # #a6adc8
+    def self.overlay(text) = rgb(108, 112, 134, text)  # #6c7086
 
     # Semantic aliases
-    def self.success(text)  = green(text)
-    def self.error(text)    = red(text)
-    def self.warning(text)  = yellow(text)
-    def self.info(text)     = sky(text)
-    def self.accent(text)   = mauve(text)
-    def self.bold(text)     = "\e[1m#{text}\e[0m"
-    def self.dim(text)      = overlay(text)
+    def self.success(text) = green(text)
+    def self.error(text) = red(text)
+    def self.warning(text) = yellow(text)
+    def self.info(text) = sky(text)
+    def self.accent(text) = mauve(text)
+    def self.bold(text) = "\e[1m#{text}\e[0m"
+    def self.dim(text) = overlay(text)
 
     # Gum hex colors (without #)
-    GUM_GREEN    = "a6e3a1"
-    GUM_RED      = "f38ba8"
-    GUM_YELLOW   = "f9e2af"
-    GUM_BLUE     = "89b4fa"
-    GUM_MAUVE    = "cba6f7"
-    GUM_TEAL     = "94e2d5"
-    GUM_PEACH    = "fab387"
-    GUM_PINK     = "f5c2e7"
-    GUM_SKY      = "89dceb"
+    GUM_GREEN = "a6e3a1"
+    GUM_RED = "f38ba8"
+    GUM_YELLOW = "f9e2af"
+    GUM_BLUE = "89b4fa"
+    GUM_MAUVE = "cba6f7"
+    GUM_TEAL = "94e2d5"
+    GUM_PEACH = "fab387"
+    GUM_PINK = "f5c2e7"
+    GUM_SKY = "89dceb"
     GUM_LAVENDER = "b4befe"
-    GUM_TEXT     = "cdd6f4"
-    GUM_SUBTEXT  = "a6adc8"
-    GUM_OVERLAY  = "6c7086"
-    GUM_BASE     = "1e1e2e"
+    GUM_TEXT = "cdd6f4"
+    GUM_SUBTEXT = "a6adc8"
+    GUM_OVERLAY = "6c7086"
+    GUM_BASE = "1e1e2e"
   end
 
   # Gum wrapper with fallback to basic terminal
@@ -120,14 +120,14 @@ module RailsMcpConfig
     def choose(prompt, options, allow_cancel: true)
       return nil if options.empty?
 
-      options = options + ["Cancel"] if allow_cancel
+      options += ["Cancel"] if allow_cancel
 
       if gum_available?
-        result = `gum choose --header "#{prompt}" \
+        result = %x(gum choose --header "#{prompt}" \
           --header.foreground "##{Colors::GUM_MAUVE}" \
           --cursor.foreground "##{Colors::GUM_PINK}" \
           --item.foreground "##{Colors::GUM_TEXT}" \
-          #{options.map { |o| "'#{o}'" }.join(" ")}`.strip
+          #{options.map { |o| "'#{o}'" }.join(" ")}).strip
         return nil if result.empty? || result == "Cancel" || separator?(result)
         result
       else
@@ -162,12 +162,12 @@ module RailsMcpConfig
       return [] if options.empty?
 
       if gum_available?
-        result = `gum choose --no-limit --header "#{prompt}" \
+        result = %x(gum choose --no-limit --header "#{prompt}" \
           --header.foreground "##{Colors::GUM_MAUVE}" \
           --cursor.foreground "##{Colors::GUM_PINK}" \
           --item.foreground "##{Colors::GUM_TEXT}" \
           --selected.foreground "##{Colors::GUM_GREEN}" \
-          #{options.map { |o| "'#{o}'" }.join(" ")}`.strip
+          #{options.map { |o| "'#{o}'" }.join(" ")}).strip
         result.split("\n").map(&:strip).reject(&:empty?)
       else
         puts
@@ -183,7 +183,7 @@ module RailsMcpConfig
         return options.dup if input == "all"
 
         indices = input.split(/[\s,]+/).map(&:to_i)
-        indices.select { |i| i >= 1 && i <= options.length }.map { |i| options[i - 1] }
+        indices.select { |i| i.between?(1, options.length) }.map { |i| options[i - 1] }
       end
     end
 
@@ -247,7 +247,7 @@ module RailsMcpConfig
         all_rows = [headers] + rows
         widths = headers.map.with_index do |_, i|
           calculated = all_rows.map { |row| row[i].to_s.length }.max
-          max_widths && max_widths[i] ? [calculated, max_widths[i]].min : calculated
+          (max_widths && max_widths[i]) ? [calculated, max_widths[i]].min : calculated
         end
 
         # Print header
@@ -293,7 +293,7 @@ module RailsMcpConfig
 
       spinner_thread = Thread.new do
         i = 0
-        while !stop_spinner
+        until stop_spinner
           print "\r#{Colors.pink(frames[i % frames.length])} #{Colors.text(title)}"
           $stdout.flush
           sleep 0.08
@@ -716,7 +716,7 @@ module RailsMcpConfig
       # Check download status for each guide
       guide_status = available.map do |guide|
         downloaded = guide_downloaded?(guide)
-        { name: guide, downloaded: downloaded }
+        {name: guide, downloaded: downloaded}
       end
 
       # Build options with clear status
@@ -743,23 +743,21 @@ module RailsMcpConfig
       force = ui.confirm("Force re-download (overwrite existing)?", default: false)
 
       puts
-      total_results = { downloaded: 0, skipped: 0, failed: 0 }
+      total_results = {downloaded: 0, skipped: 0, failed: 0}
 
       guide_names.each do |guide|
         puts Colors.sky("Downloading #{guide}...")
 
         results = ui.spin("  Fetching files...") do
-          begin
-            downloader = RailsMcpServer::ResourceDownloader.new(
-              guide,
-              config_dir: config_dir,
-              force: force,
-              verbose: false
-            )
-            downloader.download
-          rescue => e
-            { downloaded: 0, skipped: 0, failed: 1, error: e.message }
-          end
+          downloader = RailsMcpServer::ResourceDownloader.new(
+            guide,
+            config_dir: config_dir,
+            force: force,
+            verbose: false
+          )
+          downloader.download
+        rescue => e
+          {downloaded: 0, skipped: 0, failed: 1, error: e.message}
         end
 
         if results[:error]
@@ -818,18 +816,16 @@ module RailsMcpConfig
       puts Colors.sky("Importing from #{File.basename(path)}...")
 
       results = ui.spin("  Processing files...") do
-        begin
-          importer = RailsMcpServer::ResourceImporter.new(
-            "custom",
-            config_dir: config_dir,
-            source_path: expanded,
-            force: force,
-            verbose: false
-          )
-          importer.import
-        rescue => e
-          { imported: 0, skipped: 0, failed: 1, error: e.message }
-        end
+        importer = RailsMcpServer::ResourceImporter.new(
+          "custom",
+          config_dir: config_dir,
+          source_path: expanded,
+          force: force,
+          verbose: false
+        )
+        importer.import
+      rescue => e
+        {imported: 0, skipped: 0, failed: 1, error: e.message}
       end
 
       if results[:error]
@@ -852,7 +848,7 @@ module RailsMcpConfig
         name = File.basename(file, ".md")
         size = File.size(file)
         mtime = File.mtime(file)
-        { name: name, path: file, size: size, mtime: mtime }
+        {name: name, path: file, size: size, mtime: mtime}
       end.sort_by { |f| f[:name] }
     end
 
@@ -1020,12 +1016,12 @@ module RailsMcpConfig
     end
 
     def generate_example_config(mode, url = nil)
-      config = { "mcpServers" => {} }
+      config = {"mcpServers" => {}}
 
-      if mode == :stdio
-        config["mcpServers"]["railsMcpServer"] = generate_stdio_config
+      config["mcpServers"]["railsMcpServer"] = if mode == :stdio
+        generate_stdio_config
       else
-        config["mcpServers"]["railsMcpServer"] = generate_http_config(url || "http://localhost:3001/mcp")
+        generate_http_config(url || "http://localhost:3001/mcp")
       end
 
       config
@@ -1057,8 +1053,8 @@ module RailsMcpConfig
           ui.success("Rails MCP Server is configured")
           puts
           puts Colors.lavender("Current configuration:")
-          puts Colors.text("  command: #{rails_config['command']}")
-          puts Colors.text("  args: #{rails_config['args']&.join(' ') || '(none)'}")
+          puts Colors.text("  command: #{rails_config["command"]}")
+          puts Colors.text("  args: #{rails_config["args"]&.join(" ") || "(none)"}")
         else
           ui.warning("Rails MCP Server is NOT configured")
         end
@@ -1273,7 +1269,7 @@ module RailsMcpConfig
       config_file = claude_config_path
       return unless File.exist?(config_file)
 
-      backup_file = "#{config_file}.backup.#{Time.now.strftime('%Y%m%d_%H%M%S')}"
+      backup_file = "#{config_file}.backup.#{Time.now.strftime("%Y%m%d_%H%M%S")}"
       FileUtils.cp(config_file, backup_file)
       ui.success("Backed up existing config to: #{File.basename(backup_file)}")
     end
@@ -1364,7 +1360,7 @@ module RailsMcpConfig
 end
 
 # Entry point
-if __FILE__ == $0
+if __FILE__ == $0 || File.basename($0) == "rails-mcp-config"
   require "shellwords"
 
   # Handle --help

data/lib/rails-mcp-server/analyzers/analyze_controller_views.rb

@@ -63,7 +63,7 @@ module RailsMcpServer
 
       def format_summary(controller_class, file_path, relative_path)
         data = get_controller_summary(controller_class)
-        output = ["#{controller_class}", "  File: #{relative_path}", "  Actions: #{data[:actions].size}"]
+        output = [controller_class.to_s, "  File: #{relative_path}", "  Actions: #{data[:actions].size}"]
         data[:actions].each do |action|
           route = data[:routes].find { |r| r[:action] == action }
           output << if route
@@ -148,7 +148,7 @@ module RailsMcpServer
             opts = []
             opts << "only: [#{cb[:only].join(", ")}]" if cb[:only]&.any?
             opts << "except: [#{cb[:except].join(", ")}]" if cb[:except]&.any?
-            output << "  #{cb[:kind]}_action :#{cb[:filter]}#{opts.any? ? ", #{opts.join(", ")}" : ""}"
+            output << "  #{cb[:kind]}_action :#{cb[:filter]}#{", #{opts.join(", ")}" if opts.any?}"
           end
         end
 

data/lib/rails-mcp-server/analyzers/analyze_models.rb

@@ -9,7 +9,7 @@ module RailsMcpServer
         detail_level = "full" unless %w[names associations full].include?(detail_level)
         analysis_type = "introspection" unless %w[introspection static full].include?(analysis_type)
 
-        if model_names && model_names.is_a?(Array) && model_names.any?
+        if model_names&.is_a?(Array) && model_names.any?
           return batch_model_info(model_names, detail_level, analysis_type)
         end
 

data/lib/rails-mcp-server/analyzers/get_routes.rb

@@ -152,7 +152,7 @@ module RailsMcpServer
           "Route paths (#{paths.size} unique):\n\n#{paths.join("\n")}"
 
         when "summary"
-          output = +"Rails Routes (#{routes.size} routes):\n"
+          output = "Rails Routes (#{routes.size} routes):\n"
 
           by_controller = routes.group_by { |r| r[:controller] }
 
@@ -169,7 +169,7 @@ module RailsMcpServer
           output
 
         when "full"
-          output = +"Rails Routes (#{routes.size} routes):\n"
+          output = "Rails Routes (#{routes.size} routes):\n"
           output << "=" * 70 << "\n"
 
           routes.each do |r|

data/lib/rails-mcp-server/analyzers/get_schema.rb

@@ -10,7 +10,7 @@ module RailsMcpServer
 
         detail_level = "full" unless %w[tables summary full].include?(detail_level)
 
-        if table_names && table_names.is_a?(Array) && table_names.any?
+        if table_names&.is_a?(Array) && table_names.any?
           return batch_table_info(table_names)
         end
 
@@ -110,7 +110,7 @@ module RailsMcpServer
         end
 
         formatted_columns = columns.map do |name, type, nullable, default|
-          "  #{name} (#{type})#{nullable ? ", nullable" : ""}#{default ? ", default: #{default}" : ""}"
+          "  #{name} (#{type})#{", nullable" if nullable}#{", default: #{default}" if default}"
         end
 
         output = <<~SCHEMA
@@ -199,7 +199,7 @@ module RailsMcpServer
 
         formatted_indexes = indexes.map do |name, columns, unique|
           cols = columns.is_a?(Array) ? columns.join(", ") : columns
-          "  #{name} (#{cols})#{unique ? " UNIQUE" : ""}"
+          "  #{name} (#{cols})#{" UNIQUE" if unique}"
         end
 
         <<~IDX

data/lib/rails-mcp-server/analyzers/project_info.rb

@@ -8,7 +8,7 @@ module RailsMcpServer
           return message
         end
 
-        max_depth = [[max_depth.to_i, 1].max, 5].min
+        max_depth = [[max_depth.to_i, 1].max, 5].min # rubocop:disable Style/ComparableClamp
         detail_level = "full" unless %w[minimal summary full].include?(detail_level)
 
         gemfile_path = File.join(active_project_path, "Gemfile")

data/lib/rails-mcp-server/resources/guide_content_formatter.rb

@@ -40,13 +40,13 @@ module RailsMcpServer
         <<~GUIDE
           ### #{title}
           **Guide name:** `#{short_name}` or `#{full_name}`
-          #{description.empty? ? "" : "**Description:** #{description}"}
+          #{"**Description:** #{description}" unless description.empty?}
         GUIDE
       else
         <<~GUIDE
           ## #{title}
           **Guide name:** `#{short_name}`
-          #{description.empty? ? "" : "**Description:** #{description}"}
+          #{"**Description:** #{description}" unless description.empty?}
         GUIDE
       end
     end
@@ -59,7 +59,7 @@ module RailsMcpServer
       usage += "```\n"
 
       examples.each do |example|
-        usage += "load_guide guides: \"#{framework_name.downcase}\", guide: \"#{example[:guide]}\"#{example[:comment] ? " # " + example[:comment] : ""}\n"
+        usage += "load_guide guides: \"#{framework_name.downcase}\", guide: \"#{example[:guide]}\"#{" # " + example[:comment] if example[:comment]}\n"
       end
 
       usage += "```\n"

data/lib/rails-mcp-server/resources/kamal_guides_resources.rb

@@ -103,7 +103,7 @@ module RailsMcpServer
       <<~GUIDE
         ### #{title}
         **Guide name:** `#{short_name}`
-        #{description.empty? ? "" : "**Description:** #{description}"}
+        #{"**Description:** #{description}" unless description.empty?}
       GUIDE
     end
   end

data/lib/rails-mcp-server/version.rb

@@ -1,3 +1,3 @@
 module RailsMcpServer
-  VERSION = "1.4.0"
+  VERSION = "1.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-mcp-server
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.4.1
 platform: ruby
 authors:
 - Mario Alberto Chávez Cárdenas
@@ -218,7 +218,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.0
+rubygems_version: 4.0.1
 specification_version: 4
 summary: MCP server for Rails projects
 test_files: []