rails-active-mcp 3.1.10 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a329f65c3253c3a8884bcdd1fb033d7de5b25e8612db59e4dbe5983162a8d41e
-  data.tar.gz: 1efc1677b2f370fd14bcea83cdb87171f27e3ff466c27affdc14faf6c72f9730
+  metadata.gz: 151bd5ce3f4d059d3c8afc2481d37ac02766d2660a89a3a51ade7f153373ee54
+  data.tar.gz: f119f880f2b8f5b5b4c604e952e9cfff206753ceaf05bc2eb0a199c1640061de
 SHA512:
-  metadata.gz: 852559b1ad8f7e464b6653ca537bfdf8ed64b4c11f776fa444525277e61daba93f9405201c8b1bc4443aed714c9bb0baabb2ee7543d73aef31cf77c249e9e6d8
-  data.tar.gz: b2786ddb072811c79a993b664b8df73c1fd973df35bb40f5a4c09b44677e43c670d6d1a9f2597e985ff1475a360eda75f5a10f84f1b9e1b87ea2ceffa0e43969
+  metadata.gz: 7394eb360c87d5e3c891cb9f3fa330d9062198d5a18d13f2b907cb6dd1ca533b43a761fe56fa955eca71b377ce3801586f05766b45b02e7fc976876478eccd0a
+  data.tar.gz: f50dd0fa1ea1a0a026c5442b509fddaea73a31555eb473864cc26d93be5d754d3994c907598ad5b68dcc244b2127a53e0f3626c078bd8c0fc1e763c635eadb16

data/README.md

@@ -126,7 +126,7 @@ Add to your project's `.cursor/mcp.json`:
 <details>
 <summary><strong>Windsurf</strong></summary>
 
-Add to your project's `.windsurf/mcp.json`:
+Add to your global Windsurf config at `~/.codeium/windsurf/mcp_config.json`:
 
 ```json
 {
@@ -217,15 +217,23 @@ The installer creates a default configuration at `config/initializers/rails_acti
 
 ```ruby
 RailsActiveMcp.configure do |config|
-  config.allowed_commands = %w[
-    ls pwd cat head tail grep find wc
-    rails console rails runner
-    bundle exec rspec bundle exec test
-    git status git log git diff
-  ]
-  config.command_timeout = 30
+  # Safety and execution
+  config.safe_mode = true              # Block dangerous operations
+  config.command_timeout = 30          # Seconds before timeout
+  config.max_results = 100             # Limit query results
+  config.allowed_models = []           # Empty = all models allowed
+  config.custom_safety_patterns = []   # Additional patterns to block
+
+  # Logging
   config.enable_logging = true
-  config.log_level = :info
+  config.log_level = :info             # :debug, :info, :warn, :error
+  config.log_executions = false        # Log all code executions
+  config.audit_file = nil              # Path to audit log file
+
+  # Environment presets (call instead of setting individually)
+  # config.production_mode!
+  # config.development_mode!
+  # config.test_mode!
 end
 ```
 
@@ -258,6 +266,33 @@ bundle exec rails-active-mcp-server
 RAILS_MCP_DEBUG=1 bundle exec rails-active-mcp-server
 ```
 
+### Rake Tasks
+
+The gem provides several rake tasks for diagnostics and testing:
+
+```bash
+# Show status and diagnostics
+rails rails_active_mcp:status
+
+# Validate configuration
+rails rails_active_mcp:validate_config
+
+# Test MCP tools are working
+rails rails_active_mcp:test_tools
+
+# Check if code is safe
+rails rails_active_mcp:check_safety['User.delete_all']
+
+# Execute code with safety checks
+rails rails_active_mcp:execute['User.count']
+
+# Print Claude Desktop configuration
+rails rails_active_mcp:install_claude_config
+
+# Run performance benchmarks
+rails rails_active_mcp:benchmark
+```
+
 ## Available MCP Tools
 
 The Rails Active MCP server provides four powerful tools that appear automatically in any connected MCP client:
@@ -401,20 +436,3 @@ bundle exec rspec
 ## License
 
 The gem is available as open source under the [MIT License](https://opensource.org/licenses/MIT).
-
-## Changelog
-
-### Version 2.0.0 (Latest)
-
-- **BREAKING**: Migrated to official MCP Ruby SDK
-- **BREAKING**: Removed custom MCP server implementation
-- **BREAKING**: Simplified configuration options
-- **NEW**: Professional protocol handling with built-in instrumentation
-- **NEW**: Automatic MCP specification compliance
-- **IMPROVED**: 85% reduction in codebase complexity
-- **IMPROVED**: Better error handling and reporting
-- **IMPROVED**: Future-proof architecture
-
-### Previous Versions
-
-See [CHANGELOG.md](CHANGELOG.md) for detailed version history.

data/gemfiles/rails_7.0.gemfile

@@ -31,6 +31,3 @@ end
 
 # For testing the gem in a Rails app
 gem 'sprockets-rails' # Required for Rails 7+
-
-# Official MCP Ruby SDK
-gem 'mcp', '~> 0.9.2'

data/gemfiles/rails_7.1.gemfile

@@ -31,6 +31,3 @@ end
 
 # For testing the gem in a Rails app
 gem 'sprockets-rails' # Required for Rails 7+
-
-# Official MCP Ruby SDK
-gem 'mcp', '~> 0.9.2'

data/gemfiles/rails_7.2.gemfile

@@ -31,6 +31,3 @@ end
 
 # For testing the gem in a Rails app
 gem 'sprockets-rails' # Required for Rails 7+
-
-# Official MCP Ruby SDK
-gem 'mcp', '~> 0.9.2'

data/gemfiles/rails_8.0.gemfile

@@ -31,6 +31,3 @@ end
 
 # For testing the gem in a Rails app
 gem 'sprockets-rails' # Required for Rails 7+
-
-# Official MCP Ruby SDK
-gem 'mcp', '~> 0.9.2'

data/gemfiles/rails_8.1.gemfile

@@ -31,6 +31,3 @@ end
 
 # For testing the gem in a Rails app
 gem 'sprockets-rails' # Required for Rails 7+
-
-# Official MCP Ruby SDK
-gem 'mcp', '~> 0.9.2'

data/lib/rails_active_mcp/console_executor.rb

@@ -131,6 +131,8 @@ module RailsActiveMcp
 
         validators_info = build_model_validator_info(model_class)
 
+        enums_info = build_model_enums(model_class)
+
         {
           success: true,
           model_name: model_name,
@@ -139,6 +141,7 @@ module RailsActiveMcp
           columns: columns_info,
           associations: associations_info,
           validators: validators_info,
+          enums: enums_info,
           extracted_at: Time.now
         }
       end
@@ -199,6 +202,14 @@ module RailsActiveMcp
       end
     end
 
+    def build_model_enums(model_class)
+      return {} unless model_class.respond_to?(:defined_enums)
+
+      model_class.defined_enums.transform_values do |mapping|
+        mapping.transform_values(&:to_s)
+      end
+    end
+
     def dry_run(code)
       # Analyze without executing
       safety_analysis = @safety_checker.analyze(code)

data/lib/rails_active_mcp/sdk/tools/model_info_tool.rb

@@ -25,6 +25,10 @@ module RailsActiveMcp
             include_validations: {
               type: 'boolean',
               description: 'Include model validations'
+            },
+            include_enums: {
+              type: 'boolean',
+              description: 'Include enum definitions and their values'
             }
           },
           required: ['model']
@@ -38,56 +42,86 @@ module RailsActiveMcp
           open_world_hint: false
         )
 
-        def self.call(model:, server_context:, include_schema: true, include_associations: true,
-                      include_validations: true)
+        def self.call(model:, server_context:, **)
+          new(model:, **).call
+        end
+
+        def initialize(model: nil, **options) # rubocop:disable Lint/MissingSuper
+          @model = model
+          @include_schema = options.fetch(:include_schema, true)
+          @include_associations = options.fetch(:include_associations, true)
+          @include_validations = options.fetch(:include_validations, true)
+          @include_enums = options.fetch(:include_enums, true)
+        end
+
+        def call
           config = RailsActiveMcp.config
           executor = RailsActiveMcp::ConsoleExecutor.new(config)
-          result = executor.get_model_info(model)
+          @result = executor.get_model_info(@model)
 
-          return error_response(result[:error]) unless result[:success]
+          return error_response unless @result[:success]
 
-          output = []
-          output << "Model: #{result[:model_name]}"
-          output << "Table: #{result[:table_name]}"
-          output << "Primary Key: #{result[:primary_key]}"
+          @output = []
+          @output << "Model: #{@result[:model_name]}"
+          @output << "Table: #{@result[:table_name]}"
+          @output << "Primary Key: #{@result[:primary_key]}"
 
-          if include_schema
-            output << "\nSchema:"
-            result[:columns].each do |column|
-              output << "  #{column[:name]}: #{column[:type]}"
-              output << "    - Primary: #{column[:primary]}"
-            end
+          append_schema if @include_schema
+          append_associations if @include_associations
+          append_validations if @include_validations
+          append_enums if @include_enums
+
+          MCP::Tool::Response.new([
+                                    { type: 'text', text: @output.join("\n") }
+                                  ])
+        end
+
+        private
+
+        def append_schema
+          @output << "\nSchema:"
+          @result[:columns].each do |column|
+            @output << "  #{column[:name]}: #{column[:type]}"
+            @output << "    - Primary: #{column[:primary]}"
           end
+        end
 
-          if include_associations
-            output << "\nAssociations:"
-            result[:associations].each do |assoc|
-              output << "  #{assoc[:name]}: #{assoc[:type]} -> #{assoc[:class_name]}"
-            end
+        def append_associations
+          @output << "\nAssociations:"
+          @result[:associations].each do |assoc|
+            @output << "  #{assoc[:name]}: #{assoc[:type]} -> #{assoc[:class_name]}"
           end
+        end
 
-          if include_validations && result[:validators]&.any?
-            output << "\nValidations:"
-            validations = {}
-            result[:validators].each do |validator|
-              validator[:attributes].each do |attribute|
-                validations[attribute] ||= []
-                validations[attribute] << validator[:type].to_s.split('::').last
-              end
-            end
-            validations.each do |attr, validators|
-              output << "  #{attr}: #{validators.join(', ')}"
+        def append_validations
+          return unless @result[:validators]&.any?
+
+          @output << "\nValidations:"
+          validations = {}
+          @result[:validators].each do |validator|
+            validator[:attributes].each do |attribute|
+              validations[attribute] ||= []
+              validations[attribute] << validator[:type].to_s.split('::').last
             end
           end
+          validations.each do |attr, validators|
+            @output << "  #{attr}: #{validators.join(', ')}"
+          end
+        end
 
-          MCP::Tool::Response.new([
-                                    { type: 'text', text: output.join("\n") }
-                                  ])
+        def append_enums
+          return unless @result[:enums]&.any?
+
+          @output << "\nEnums:"
+          @result[:enums].each do |attribute, mapping|
+            values = mapping.map { |label, db_value| "#{label} (#{db_value})" }.join(', ')
+            @output << "  #{attribute}: #{values}"
+          end
         end
 
-        def self.error_response(message)
+        def error_response
           MCP::Tool::Response.new(
-            [{ type: 'text', text: message }],
+            [{ type: 'text', text: @result[:error] }],
             error: true
           )
         end

data/lib/rails_active_mcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsActiveMcp
-  VERSION = '3.1.10'
+  VERSION = '3.2.0'
 end

data/rails_active_mcp.gemspec

@@ -63,7 +63,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'rails', '>= 7.0', '< 9.0'
 
   # MCP SDK - Core protocol implementation (MCP 2025-11-25 spec)
-  spec.add_dependency 'mcp', '~> 0.9.2'
+  spec.add_dependency 'mcp', '>= 0.9.2', '< 1.0.0'
 
   # Core dependencies
   spec.add_dependency 'json', '~> 2.0'
@@ -71,11 +71,11 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'timeout', '~> 0.4'
 
   # Development dependencies - keep versions consistent with Gemfile
-  spec.add_development_dependency 'colorize', '~> 0.8'
+  spec.add_development_dependency 'colorize', '~> 1.1'
   spec.add_development_dependency 'factory_bot_rails', '~> 6.0'
-  spec.add_development_dependency 'faker', '~> 2.19'
+  spec.add_development_dependency 'faker', '~> 3.6'
   spec.add_development_dependency 'rspec', '~> 3.1'
-  spec.add_development_dependency 'rspec-rails', '~> 6.0'
+  spec.add_development_dependency 'rspec-rails', '~> 8.0'
   spec.add_development_dependency 'rubocop', '~> 1.77'
   spec.add_development_dependency 'rubocop-rails', '~> 2.32'
   spec.add_development_dependency 'rubocop-rspec', '~> 3.0'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rails-active-mcp
 version: !ruby/object:Gem::Version
-  version: 3.1.10
+  version: 3.2.0
 platform: ruby
 authors:
 - Brandyn Britton
 bindir: exe
 cert_chain: []
-date: 2026-04-01 00:00:00.000000000 Z
+date: 2026-04-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -47,16 +47,22 @@ dependencies:
   name: mcp
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -111,14 +117,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '1.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: factory_bot_rails
   requirement: !ruby/object:Gem::Requirement
@@ -139,14 +145,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.19'
+        version: '3.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.19'
+        version: '3.6'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -167,14 +173,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '8.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '8.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement