rails-active-mcp 2.0.8 → 2.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c09ba8583ba6900c91cef975c1942d1e5615c27d40c06d4bd58a05e755af0187
-  data.tar.gz: c30c261d6991156ea8f4ab01ab28bd9de1e51443cbd50e1f53b18e0c7cad85f1
+  metadata.gz: fee611445971a5e113a23146281a9f2a68d0c8c0690213df2704ee7fb80f7700
+  data.tar.gz: ce6ba7ab86616fd0a5a0e60aff50e9c4e8f29101a9866597e1dfd99ef2c6ee85
 SHA512:
-  metadata.gz: 50e1b520e0ee3b5ceb79543c451176cf40569759a07660c7609b7c4ba4d2c97cbaacd10281c377a323d96600573f36526c9838a4795b120016d5cccace12e690
-  data.tar.gz: 26ed8f90667ceefd1c83240e2f193c8b53bd5b9fe2b2b077cfb7d880fba58b288e03b0a0fe4ed08a463150712286a44d54016f19a1789e5877bcc837334343d2
+  metadata.gz: 312b0f2384b4cc7a57b0be9284a52c559897d10e31487eb859cd70b9e5dc385a1005a245cff4a42b7d3abe7f0480b1fdcd8caa317e7ff2388fbeb635ed447c13
+  data.tar.gz: 875467cc1ad75645d32607f2c6c3a98951807da776b626dc113f186720fc6042fe90303fe19ae8c230f036a2a085e6caa1e38e518da0a3ef71356d2cbbce10fd

data/.rubocop.yml

@@ -0,0 +1,141 @@
+plugins:
+  - rubocop-rails
+  - rubocop-rspec
+
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false
+  TargetRubyVersion: 3.1
+  Exclude:
+    - 'bin/bundle'
+    - 'bin/setup'
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'db/schema.rb'
+    - 'log/**/*'
+
+# Documentation is not always necessary for utility classes and tools
+Style/Documentation:
+  Enabled: false
+
+# Allow longer classes for main functionality classes
+Metrics/ClassLength:
+  Max: 400
+  Exclude:
+    - 'bin/*'
+
+# Allow longer methods for setup/configuration methods
+Metrics/MethodLength:
+  Max: 50
+  Exclude:
+    - 'bin/*'
+    - 'lib/generators/**/*'
+
+# Allow higher complexity for main execution methods
+Metrics/AbcSize:
+  Max: 55
+  Exclude:
+    - 'bin/*'
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/PerceivedComplexity:
+  Max: 15
+
+# Allow longer blocks in specs and configuration
+Metrics/BlockLength:
+  Max: 50
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/rails_active_mcp/tasks.rake'
+    - 'lib/generators/**/*'
+
+# Allow longer lines for error messages and documentation
+Layout/LineLength:
+  Max: 150
+  Exclude:
+    - 'bin/*'
+    - 'exe/*'
+
+# Disable some style checks that are too strict for utility scripts
+Lint/UnusedMethodArgument:
+  Enabled: false
+
+# Allow safe navigation preference but don't enforce it everywhere
+Style/SafeNavigation:
+  Enabled: true
+
+# Allow both single and double quotes
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+# Don't enforce frozen string literals in every file
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+# Allow numeric comparisons with zero
+Style/NumericPredicate:
+  Enabled: false
+
+# Rails specific configurations
+Rails:
+  Enabled: true
+
+# RSpec specific configurations
+RSpec:
+  Enabled: true
+
+# Gemspec specific configurations
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+# Allow some duplication in methods that handle similar cases
+Lint/DuplicateMethods:
+  Enabled: false
+
+Lint/DuplicateBranch:
+  Enabled: false
+
+# RSpec specific overrides for test quality
+RSpec/MultipleExpectations:
+  Max: 5
+
+RSpec/ExampleLength:
+  Max: 15
+
+RSpec/DescribeClass:
+  Enabled: false
+
+RSpec/InstanceVariable:
+  Enabled: false
+
+RSpec/BeforeAfterAll:
+  Enabled: false
+
+RSpec/VerifiedDoubles:
+  Enabled: false
+
+RSpec/MessageSpies:
+  Enabled: false
+
+RSpec/MessageChain:
+  Enabled: false
+
+RSpec/ReceiveMessages:
+  Enabled: false
+
+RSpec/ScatteredSetup:
+  Enabled: false
+
+RSpec/SpecFilePathFormat:
+  Enabled: false
+
+# Allow Time.zone vs Time.now flexibility
+Rails/TimeZone:
+  Enabled: false
+
+# Naming conventions - allow short parameter names in specs/tools
+Naming/MethodParameterName:
+  Exclude:
+    - 'spec/**/*' 

data/README.md

@@ -24,13 +24,13 @@ gem 'rails-active-mcp'
 And then execute:
 
 ```bash
-$ bundle install
+bundle install
 ```
 
 Run the installer:
 
 ```bash
-$ rails generate rails_active_mcp:install
+rails generate rails_active_mcp:install
 ```
 
 This will:
@@ -298,4 +298,4 @@ The gem is available as open source under the [MIT License](https://opensource.o
 
 ### Previous Versions
 
-See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
+See [CHANGELOG.md](CHANGELOG.md) for detailed version history.

data/exe/rails-active-mcp-server

@@ -4,11 +4,11 @@
 # Require essential gems first
 require 'json'
 require 'stringio'
+require 'fileutils'
 
 # CRITICAL: Redirect stdout IMMEDIATELY for stdio mode to prevent any output interference
 # This must happen before any other gem loading
 original_stdout = $stdout
-original_stderr = $stderr
 
 # Determine if we should redirect output (stdio mode or explicit request)
 should_redirect = (ARGV.first == 'stdio' || ARGV.first.nil?) && !ENV['RAILS_MCP_DEBUG']
@@ -16,7 +16,7 @@ should_redirect = (ARGV.first == 'stdio' || ARGV.first.nil?) && !ENV['RAILS_MCP_
 if should_redirect
   # Create log directory early
   log_dir = File.join(Dir.pwd, 'log')
-  Dir.mkdir(log_dir) unless Dir.exist?(log_dir)
+  FileUtils.mkdir_p(log_dir)
 
   # Redirect stderr to log file immediately, before any loading
   stderr_log = File.join(log_dir, 'rails_mcp_stderr.log')
@@ -74,8 +74,8 @@ end
 
 # Parse command line options
 transport = ARGV[0] || 'stdio'
-port = ARGV.include?('--port') ? ARGV[ARGV.index('--port') + 1].to_i : 3001
-host = ARGV.include?('--host') ? ARGV[ARGV.index('--host') + 1] : 'localhost'
+ARGV.include?('--port') ? ARGV[ARGV.index('--port') + 1].to_i : 3001
+ARGV.include?('--host') ? ARGV[ARGV.index('--host') + 1] : 'localhost'
 
 # Determine and set correct working directory
 def find_rails_root(start_dir = Dir.pwd)
@@ -116,7 +116,9 @@ elsif rails_root.nil?
     warn "[#{Time.now}] [RAILS-MCP] ERROR: Could not locate Gemfile in current directory: #{Dir.pwd}"
     warn "[#{Time.now}] [RAILS-MCP] ERROR: Please ensure you're running from a Rails application root directory"
     warn "[#{Time.now}] [RAILS-MCP] ERROR: Current directory contents:"
-    Dir.entries('.').each { |entry| warn "[#{Time.now}] [RAILS-MCP] ERROR:   #{entry}" unless entry.start_with?('.') }
+    Dir.entries('.').each do |entry|
+      warn "[#{Time.now}] [RAILS-MCP] ERROR:   #{entry}" unless entry.start_with?('.')
+    end
     exit(1)
   end
 end
@@ -132,9 +134,7 @@ when 'stdio'
     require_relative '../lib/rails_active_mcp/sdk/server'
 
     # Log startup information
-    if should_redirect
-      warn "[#{Time.now}] [RAILS-MCP] INFO: Starting Rails Active MCP Server v#{RailsActiveMcp::VERSION}"
-    end
+    warn "[#{Time.now}] [RAILS-MCP] INFO: Starting Rails Active MCP Server v#{RailsActiveMcp::VERSION}" if should_redirect
     warn "[#{Time.now}] [RAILS-MCP] INFO: Rails loaded: #{rails_loaded}" if should_redirect
     if rails_load_error && should_redirect
       warn "[#{Time.now}] [RAILS-MCP] WARNING: Rails load error: #{rails_load_error.class.name}: #{rails_load_error.message}"

data/gemfiles/rails_6.0.gemfile

@@ -0,0 +1,34 @@
+# Rails 6.0 Gemfile for CI testing
+source 'https://rubygems.org'
+
+# Specify the Rails version
+gem 'rails', '~> 6.0'
+
+# Include the main gemspec
+gemspec path: '../'
+
+group :development, :test do
+  gem 'byebug'
+  gem 'database_cleaner-active_record', '~> 2.1'
+  gem 'factory_bot_rails', '~> 6.0'
+  gem 'rspec', '~> 3.1'
+  gem 'rspec-rails'
+  gem 'sqlite3', '~> 2.7'
+  gem 'timecop', '~> 0.9.8'
+  gem 'webmock', '~> 3.19'
+end
+
+group :development do
+  gem 'redcarpet' # For YARD markdown support
+  gem 'rubocop', '~> 1.77'
+  gem 'rubocop-rails', '~> 2.32'
+  gem 'rubocop-rspec'
+  gem 'simplecov', '~> 0.22'
+  gem 'yard'
+end
+
+# For testing the gem in a Rails app
+gem 'sprockets-rails' # Required for Rails 7+
+
+# Official MCP Ruby SDK for migration
+gem 'mcp', '~> 0.1.0'

data/gemfiles/rails_6.1.gemfile

@@ -0,0 +1,34 @@
+# Rails 6.0 Gemfile for CI testing
+source 'https://rubygems.org'
+
+# Specify the Rails version
+gem 'rails', '~> 6.0'
+
+# Include the main gemspec
+gemspec path: '../'
+
+group :development, :test do
+  gem 'byebug'
+  gem 'database_cleaner-active_record', '~> 2.1'
+  gem 'factory_bot_rails', '~> 6.0'
+  gem 'rspec', '~> 3.1'
+  gem 'rspec-rails'
+  gem 'sqlite3', '~> 2.7'
+  gem 'timecop', '~> 0.9.8'
+  gem 'webmock', '~> 3.19'
+end
+
+group :development do
+  gem 'redcarpet' # For YARD markdown support
+  gem 'rubocop', '~> 1.77'
+  gem 'rubocop-rails', '~> 2.32'
+  gem 'rubocop-rspec'
+  gem 'simplecov', '~> 0.22'
+  gem 'yard'
+end
+
+# For testing the gem in a Rails app
+gem 'sprockets-rails' # Required for Rails 7+
+
+# Official MCP Ruby SDK for migration
+gem 'mcp', '~> 0.1.0'

data/gemfiles/rails_7.0.gemfile

@@ -0,0 +1,34 @@
+# Rails 7.0 Gemfile for CI testing
+source 'https://rubygems.org'
+
+# Specify the Rails version
+gem 'rails', '~> 7.0.0'
+
+# Include the main gemspec
+gemspec path: '../'
+
+group :development, :test do
+  gem 'byebug'
+  gem 'database_cleaner-active_record', '~> 2.1'
+  gem 'factory_bot_rails', '~> 6.0'
+  gem 'rspec', '~> 3.1'
+  gem 'rspec-rails'
+  gem 'sqlite3', '~> 2.7'
+  gem 'timecop', '~> 0.9.8'
+  gem 'webmock', '~> 3.19'
+end
+
+group :development do
+  gem 'redcarpet' # For YARD markdown support
+  gem 'rubocop', '~> 1.77'
+  gem 'rubocop-rails', '~> 2.32'
+  gem 'rubocop-rspec'
+  gem 'simplecov', '~> 0.22'
+  gem 'yard'
+end
+
+# For testing the gem in a Rails app
+gem 'sprockets-rails' # Required for Rails 7+
+
+# Official MCP Ruby SDK for migration
+gem 'mcp', '~> 0.1.0'

data/gemfiles/rails_7.1.gemfile

@@ -7,28 +7,28 @@ gem 'rails', '~> 7.1.0'
 # Include the main gemspec
 gemspec path: '../'
 
-# Rails 7.1 specific dependencies
-gem 'importmap-rails', '>= 1.0'
-gem 'sprockets-rails', '>= 3.4.0'
-gem 'stimulus-rails', '>= 1.0'
-gem 'turbo-rails', '>= 1.0'
-
-# Database adapters
-gem 'mysql2', '~> 0.5'
-gem 'pg', '~> 1.1'
-gem 'sqlite3', '~> 1.6'
-
-# Testing gems
-gem 'factory_bot_rails', '~> 6.0'
-gem 'faker', '~> 3.0'
-gem 'rspec-rails', '~> 6.0'
-
-# Development and debugging
-gem 'debug', '>= 1.0.0'
-gem 'web-console', '>= 4.0'
-
 group :development, :test do
-  gem 'rubocop'
-  gem 'rubocop-rails'
+  gem 'byebug'
+  gem 'database_cleaner-active_record', '~> 2.1'
+  gem 'factory_bot_rails', '~> 6.0'
+  gem 'rspec', '~> 3.1'
+  gem 'rspec-rails'
+  gem 'sqlite3', '~> 2.7'
+  gem 'timecop', '~> 0.9.8'
+  gem 'webmock', '~> 3.19'
+end
+
+group :development do
+  gem 'redcarpet' # For YARD markdown support
+  gem 'rubocop', '~> 1.77'
+  gem 'rubocop-rails', '~> 2.32'
   gem 'rubocop-rspec'
+  gem 'simplecov', '~> 0.22'
+  gem 'yard'
 end
+
+# For testing the gem in a Rails app
+gem 'sprockets-rails' # Required for Rails 7+
+
+# Official MCP Ruby SDK for migration
+gem 'mcp', '~> 0.1.0'

data/gemfiles/rails_7.2.gemfile

@@ -0,0 +1,34 @@
+# Rails 7.2 Gemfile for CI testing
+source 'https://rubygems.org'
+
+# Specify the Rails version
+gem 'rails', '~> 7.2.0'
+
+# Include the main gemspec
+gemspec path: '../'
+
+group :development, :test do
+  gem 'byebug'
+  gem 'database_cleaner-active_record', '~> 2.1'
+  gem 'factory_bot_rails', '~> 6.0'
+  gem 'rspec', '~> 3.1'
+  gem 'rspec-rails'
+  gem 'sqlite3', '~> 2.7'
+  gem 'timecop', '~> 0.9.8'
+  gem 'webmock', '~> 3.19'
+end
+
+group :development do
+  gem 'redcarpet' # For YARD markdown support
+  gem 'rubocop', '~> 1.77'
+  gem 'rubocop-rails', '~> 2.32'
+  gem 'rubocop-rspec'
+  gem 'simplecov', '~> 0.22'
+  gem 'yard'
+end
+
+# For testing the gem in a Rails app
+gem 'sprockets-rails' # Required for Rails 7+
+
+# Official MCP Ruby SDK for migration
+gem 'mcp', '~> 0.1.0'

data/lib/generators/rails_active_mcp/install/install_generator.rb

@@ -3,7 +3,7 @@
 module RailsActiveMcp
   module Generators
     class InstallGenerator < Rails::Generators::Base
-      source_root File.expand_path('templates', __dir__)
+      source_root File.expand_path('templates', __dir__ || File.dirname(__FILE__))
 
       desc 'Install Rails Active MCP'
 
@@ -11,81 +11,14 @@ module RailsActiveMcp
         template 'initializer.rb', 'config/initializers/rails_active_mcp.rb'
       end
 
-      def create_binstub
-        # Create binstub for easy server execution
-        create_file 'bin/rails-active-mcp-server', <<~RUBY
-          #!/usr/bin/env ruby
-
-          # Binstub for Rails Active MCP Server
-          # This ensures the server runs within the Rails project context
-
-          require 'bundler/setup'
-
-          # Set Rails environment
-          ENV['RAILS_ENV'] ||= 'development'
-
-          # Load Rails application first
-          require_relative '../config/environment'
-
-          # Now start the MCP server using the SDK implementation
-          require 'rails_active_mcp/sdk/server'
-
-          begin
-            server = RailsActiveMcp::SDK::Server.new
-            server.run
-          rescue StandardError => e
-            warn "Error starting Rails Active MCP server: \#{e.message}"
-            warn e.backtrace if ENV['RAILS_MCP_DEBUG'] == '1'
-            exit 1
-          end
-        RUBY
+      def create_wrapper_script
+        template 'rails-active-mcp-wrapper', 'bin/rails-active-mcp-wrapper'
+        chmod 'bin/rails-active-mcp-wrapper', 0o755
+      end
 
+      def create_server_script
+        template 'rails-active-mcp-server', 'bin/rails-active-mcp-server'
         chmod 'bin/rails-active-mcp-server', 0o755
-        say 'Created Rails binstub at bin/rails-active-mcp-server', :green
-
-        # Create environment-aware wrapper for Claude Desktop compatibility
-        ruby_path = `which ruby`.strip
-
-        create_file 'bin/rails-active-mcp-wrapper', <<~BASH
-          #!/usr/bin/env bash
-
-          # Rails Active MCP Wrapper Script
-          # Ensures correct Ruby environment for Claude Desktop execution
-
-          # Fix Claude Desktop environment isolation issues
-          export HOME="${HOME:-#{ENV['HOME']}}"
-          export USER="${USER:-$(whoami)}"
-
-          # Strategy 1: Use absolute Ruby path (most reliable)
-          RUBY_PATH="#{ruby_path}"
-
-          # Strategy 2: Try /usr/local/bin/ruby symlink as fallback
-          if [ ! -x "$RUBY_PATH" ]; then
-              RUBY_PATH="/usr/local/bin/ruby"
-          fi
-
-          # Strategy 3: Setup environment and use PATH resolution as last resort
-          if [ ! -x "$RUBY_PATH" ]; then
-              # Set up asdf environment if available
-              export ASDF_DIR="$HOME/.asdf"
-              if [ -f "$ASDF_DIR/asdf.sh" ]; then
-                  source "$ASDF_DIR/asdf.sh"
-              fi
-          #{'    '}
-              # Add version manager paths
-              export PATH="$HOME/.asdf/shims:$HOME/.rbenv/shims:$HOME/.rvm/bin:$PATH"
-              RUBY_PATH="ruby"
-          fi
-
-          # Change to the Rails project directory
-          cd "$(dirname "$0")/.."
-
-          # Execute with the determined Ruby path
-          exec "$RUBY_PATH" bin/rails-active-mcp-server "$@"
-        BASH
-
-        chmod 'bin/rails-active-mcp-wrapper', 0o755
-        say 'Created environment wrapper at bin/rails-active-mcp-wrapper', :green
       end
 
       def create_mcp_config
@@ -96,59 +29,76 @@ module RailsActiveMcp
         readme 'README.md' if behavior == :invoke
       end
 
+      # rubocop:disable Metrics/AbcSize
       def show_post_install_instructions
         return unless behavior == :invoke
 
-        say "\n" + '=' * 50, :green
+        say "\n#{'=' * 50}", :green
         say 'Rails Active MCP Installation Complete!', :green
         say '=' * 50, :green
+        say "\nFiles created:", :green
+        say '✅ config/initializers/rails_active_mcp.rb', :yellow
+        say '✅ bin/rails-active-mcp-wrapper', :yellow
+        say '✅ bin/rails-active-mcp-server', :yellow
+        say '✅ mcp.ru', :yellow
+        say '', :green
+        say "\nQuick Test:", :green
+        say '1. Test the server: bin/rails-active-mcp-wrapper', :yellow
+        say '2. Should show JSON responses (not plain text)', :yellow
+        say '3. Exit with Ctrl+C', :yellow
+        say '', :green
         say "\nFor Claude Desktop configuration:", :green
         say 'Add this to your claude_desktop_config.json:', :yellow
         say '', :green
         say '{', :cyan
         say '  "mcpServers": {', :cyan
         say '    "rails-active-mcp": {', :cyan
-        say "      \"command\": \"#{Rails.root}/bin/rails-active-mcp-wrapper\",", :cyan
+        say "      \"command\": \"#{Rails.root.join('bin/rails-active-mcp-wrapper')}\",", :cyan
         say "      \"cwd\": \"#{Rails.root}\",", :cyan
         say '      "env": {', :cyan
-        say '        "RAILS_ENV": "development",', :cyan
-        say "        \"HOME\": \"#{ENV['HOME']}\"", :cyan
+        say '        "RAILS_ENV": "development"', :cyan
         say '      }', :cyan
         say '    }', :cyan
         say '  }', :cyan
         say '}', :cyan
         say '', :green
+        say 'Config file locations:', :green
+        say '  macOS: ~/.config/claude-desktop/claude_desktop_config.json', :yellow
+        say '  Windows: %APPDATA%\\Claude\\claude_desktop_config.json', :yellow
+        say '', :green
         say "\nAvailable Tools in Claude Desktop:", :green
         say '- console_execute: Execute Ruby code with safety checks', :yellow
         say '- model_info: Get detailed information about Rails models', :yellow
         say '- safe_query: Execute safe read-only database queries', :yellow
         say '- dry_run: Analyze Ruby code for safety without execution', :yellow
         say '', :green
-        say "\nWhy use the wrapper?", :green
-        say '- Handles Ruby version manager environments (asdf, rbenv, etc.)', :yellow
-        say '- Prevents "bundler version" and "Ruby version" conflicts', :yellow
-        say '- Works reliably across different development setups', :yellow
-        say "\nAlternative (if wrapper doesn't work):", :green
-        say 'Use bin/rails-active-mcp-server instead of the wrapper', :yellow
-        say "\nTesting:", :green
-        say '1. Test manually: bin/rails-active-mcp-wrapper', :yellow
-        say '2. Should output JSON responses (not plain text)', :yellow
-        say '3. Restart Claude Desktop after config changes', :yellow
+        say "\nExample Claude Desktop prompts:", :green
+        say '- "Show me the User model structure"', :yellow
+        say '- "How many users were created in the last week?"', :yellow
+        say '- "What are the most recent orders?"', :yellow
+        say '- "Check if this code is safe: User.delete_all"', :yellow
+        say '', :green
         say "\nTroubleshooting:", :green
-        say '- Set RAILS_MCP_DEBUG=1 for verbose logging', :yellow
-        say '- Check README.md for more configuration options', :yellow
-        say "\nFor Ruby version manager users (asdf/rbenv/RVM):", :green
-        say 'If you encounter "bundler version" errors, create a system symlink:', :yellow
-        say "sudo ln -sf #{`which ruby`.strip} /usr/local/bin/ruby", :cyan
+        say '- Debug mode: RAILS_MCP_DEBUG=1 bin/rails-active-mcp-wrapper', :yellow
+        say '- Check status: rails rails_active_mcp:status', :yellow
+        say '- Restart Claude Desktop after config changes', :yellow
+        say '- If wrapper fails, try: bin/rails-active-mcp-server', :yellow
+        say '', :green
+        say "\nNext steps:", :green
+        say '1. Test installation: rails rails_active_mcp:test_tools', :yellow
+        say '2. Configure Claude Desktop (see above)', :yellow
+        say '3. Restart Claude Desktop', :yellow
+        say '4. Start chatting with your Rails app!', :yellow
         say '=' * 50, :green
       end
+      # rubocop:enable Metrics/AbcSize
 
       private
 
       def readme(path)
         readme_path = File.join(self.class.source_root, path)
         if File.exist?(readme_path)
-          say IO.read(readme_path), :green
+          say File.read(readme_path), :green
         else
           say "README file not found at #{readme_path}", :green
         end