rails-active-mcp 2.0.8 → 2.0.12

data/lib/generators/rails_active_mcp/install/templates/rails-active-mcp-server

@@ -0,0 +1,104 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Rails Active MCP Server Script
+# This script starts the Rails Active MCP server for your Rails application
+
+# Ensure we're in the Rails application directory
+unless File.exist?('config/environment.rb') && File.exist?('Gemfile')
+  puts 'Error: This script must be run from the root of a Rails application'
+  puts "Current directory: #{Dir.pwd}"
+  puts 'Please ensure you have both config/environment.rb and Gemfile in your project root'
+  exit(1)
+end
+
+# Load bundler and ensure the gem is available
+begin
+  require 'bundler/setup'
+rescue LoadError => e
+  puts "Error: Bundler not available: #{e.message}"
+  puts 'Please run: gem install bundler'
+  exit(1)
+end
+
+# Check if rails-active-mcp is in the bundle
+begin
+  gem 'rails-active-mcp'
+rescue Gem::LoadError
+  puts 'Error: rails-active-mcp gem not found in bundle'
+  puts "Please add to your Gemfile: gem 'rails-active-mcp'"
+  puts 'Then run: bundle install'
+  exit(1)
+end
+
+# Load Rails environment
+begin
+  require_relative '../config/environment'
+rescue LoadError => e
+  puts "Error: Failed to load Rails environment: #{e.message}"
+  puts 'Please ensure your Rails application is properly configured'
+  exit(1)
+end
+
+# Load Rails Active MCP
+begin
+  require 'rails_active_mcp'
+rescue LoadError => e
+  puts "Error: Failed to load Rails Active MCP: #{e.message}"
+  puts 'Please ensure the gem is properly installed'
+  exit(1)
+end
+
+# Ensure configuration is loaded
+unless RailsActiveMcp.configuration
+  puts 'Warning: Rails Active MCP configuration not found'
+  puts 'Please run: rails generate rails_active_mcp:install'
+  puts 'Using default configuration...'
+  RailsActiveMcp.configure
+end
+
+# Start the server
+begin
+  require 'rails_active_mcp/sdk/server'
+
+  # Parse command line arguments
+  transport = ARGV[0] || 'stdio'
+
+  case transport
+  when 'stdio', nil
+    puts 'Starting Rails Active MCP Server in stdio mode...' if ENV['RAILS_MCP_DEBUG']
+    server = RailsActiveMcp::Sdk::Server.new
+    server.run_stdio
+  when '--help', '-h'
+    puts <<~HELP
+      Rails Active MCP Server
+
+      Usage: #{File.basename($PROGRAM_NAME)} [mode] [options]
+
+      Modes:
+        stdio     Start in stdio mode for MCP integration (default)
+        --help    Show this help message
+
+      Environment Variables:
+        RAILS_MCP_DEBUG=1    Enable debug logging
+        RAILS_ENV=env        Set Rails environment (default: development)
+
+      Examples:
+        #{File.basename($PROGRAM_NAME)}                    # Start in stdio mode
+        #{File.basename($PROGRAM_NAME)} stdio              # Start in stdio mode explicitly
+        RAILS_MCP_DEBUG=1 #{File.basename($PROGRAM_NAME)}  # Start with debug logging
+    HELP
+  else
+    puts "Error: Unknown transport mode '#{transport}'"
+    puts 'Use --help for usage information'
+    exit(1)
+  end
+rescue Interrupt
+  puts "\nServer stopped by user"
+  exit(0)
+rescue StandardError => e
+  puts "Error: Failed to start server: #{e.message}"
+  puts 'Backtrace:' if ENV['RAILS_MCP_DEBUG']
+  puts e.backtrace if ENV['RAILS_MCP_DEBUG']
+  exit(1)
+end

data/lib/generators/rails_active_mcp/install/templates/rails-active-mcp-wrapper

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+
+# Rails Active MCP Wrapper Script
+# This script ensures Rails Active MCP works reliably across different Ruby version managers
+
+# Function to detect Ruby version manager
+detect_ruby_manager() {
+    if command -v asdf >/dev/null 2>&1 && [ -f .tool-versions ]; then
+        echo "asdf"
+    elif command -v rbenv >/dev/null 2>&1 && [ -f .ruby-version ]; then
+        echo "rbenv"
+    elif command -v rvm >/dev/null 2>&1 && [ -f .rvmrc ]; then
+        echo "rvm"
+    else
+        echo "system"
+    fi
+}
+
+# Function to setup environment for different Ruby managers
+setup_ruby_environment() {
+    local manager=$1
+
+    case $manager in
+        "asdf")
+            if [ -n "$ASDF_DIR" ] && [ -f "$ASDF_DIR/asdf.sh" ]; then
+                source "$ASDF_DIR/asdf.sh"
+            elif [ -f "$HOME/.asdf/asdf.sh" ]; then
+                export ASDF_DIR="$HOME/.asdf"
+                source "$HOME/.asdf/asdf.sh"
+            fi
+            ;;
+        "rbenv")
+            if [ -n "$RBENV_ROOT" ] && [ -f "$RBENV_ROOT/bin/rbenv" ]; then
+                export PATH="$RBENV_ROOT/bin:$PATH"
+                eval "$(rbenv init -)"
+            elif [ -f "$HOME/.rbenv/bin/rbenv" ]; then
+                export PATH="$HOME/.rbenv/bin:$PATH"
+                eval "$(rbenv init -)"
+            fi
+            ;;
+        "rvm")
+            if [ -f "$HOME/.rvm/scripts/rvm" ]; then
+                source "$HOME/.rvm/scripts/rvm"
+            fi
+            ;;
+    esac
+}
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# Change to the Rails project directory
+cd "$PROJECT_ROOT" || {
+    echo "Error: Cannot change to project root directory: $PROJECT_ROOT" >&2
+    exit 1
+}
+
+# Detect and setup Ruby environment
+RUBY_MANAGER=$(detect_ruby_manager)
+setup_ruby_environment "$RUBY_MANAGER"
+
+# Verify we have the necessary files
+if [ ! -f "Gemfile" ]; then
+    echo "Error: Gemfile not found in $PROJECT_ROOT" >&2
+    echo "Please ensure you're running this from a Rails application root" >&2
+    exit 1
+fi
+
+if [ ! -f "config/environment.rb" ]; then
+    echo "Warning: config/environment.rb not found. This may not be a Rails application." >&2
+fi
+
+# Set default environment if not specified
+export RAILS_ENV="${RAILS_ENV:-development}"
+
+# Ensure we have the rails-active-mcp gem available
+if ! bundle list | grep -q "rails-active-mcp"; then
+    echo "Error: rails-active-mcp gem not found in bundle" >&2
+    echo "Please run: bundle install" >&2
+    exit 1
+fi
+
+# Execute the Rails Active MCP server
+# Try bundle exec first, then fall back to direct execution
+if bundle exec rails-active-mcp-server "$@" 2>/dev/null; then
+    exit 0
+elif command -v rails-active-mcp-server >/dev/null 2>&1; then
+    exec rails-active-mcp-server "$@"
+else
+    echo "Error: Cannot find rails-active-mcp-server executable" >&2
+    echo "Please ensure the rails-active-mcp gem is properly installed" >&2
+    exit 1
+fi

data/lib/rails_active_mcp/configuration.rb

@@ -8,7 +8,7 @@ module RailsActiveMcp
     attr_accessor :allowed_commands, :command_timeout, :enable_logging, :log_level
 
     # Safety and execution options
-    attr_accessor :safe_mode, :default_timeout, :max_results, :log_executions, :audit_file
+    attr_accessor :safe_mode, :max_results, :log_executions, :audit_file, :enabled
     attr_accessor :custom_safety_patterns, :allowed_models
 
     def initialize
@@ -24,12 +24,12 @@ module RailsActiveMcp
 
       # Safety and execution defaults
       @safe_mode = true
-      @default_timeout = 30
       @max_results = 100
       @log_executions = false
       @audit_file = nil
       @custom_safety_patterns = []
       @allowed_models = []
+      @enabled = true
     end
 
     def model_allowed?(model_name)
@@ -44,15 +44,55 @@ module RailsActiveMcp
         [true, false].include?(enable_logging) &&
         %i[debug info warn error].include?(log_level) &&
         [true, false].include?(safe_mode) &&
-        default_timeout.is_a?(Numeric) && default_timeout > 0 &&
         max_results.is_a?(Numeric) && max_results > 0 &&
         [true, false].include?(log_executions) &&
         custom_safety_patterns.is_a?(Array) &&
-        allowed_models.is_a?(Array)
+        allowed_models.is_a?(Array) &&
+        [true, false].include?(enabled)
+    end
+
+    def validate?
+      raise ArgumentError, 'allowed_commands must be an array' unless allowed_commands.is_a?(Array)
+
+      raise ArgumentError, 'command_timeout must be positive' unless command_timeout.is_a?(Numeric) && command_timeout > 0
+
+      raise ArgumentError, 'log_level must be one of: debug, info, warn, error' unless %i[debug info warn error].include?(log_level)
+
+      raise ArgumentError, 'safe_mode must be a boolean' unless [true, false].include?(safe_mode)
+
+      raise ArgumentError, 'max_results must be positive' unless max_results.is_a?(Numeric) && max_results > 0
+
+      raise ArgumentError, 'enabled must be a boolean' unless [true, false].include?(enabled)
+
+      true
     end
 
     def reset!
       initialize
     end
+
+    # Environment-specific configuration presets
+    def production_mode!
+      @safe_mode = true
+      @log_level = :warn
+      @command_timeout = 15
+      @max_results = 50
+      @log_executions = true
+    end
+
+    def development_mode!
+      @safe_mode = false
+      @log_level = :debug
+      @command_timeout = 60
+      @max_results = 200
+      @log_executions = false
+    end
+
+    def test_mode!
+      @safe_mode = true
+      @log_level = :error
+      @command_timeout = 30
+      @log_executions = false
+    end
   end
 end