rails-active-mcp 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 695c22b21a980b527c91e1c4d269e7ea4dc260668c2d7ee9eb135d734db95ab3
-  data.tar.gz: 34ff366ef633aef419c388ec77a3dbb768bf8b05f3a915fcf983080ff503540e
+  metadata.gz: ab07c3ba6b1a97791cbaa3345aadb3cc43fb2c28b6c5008bace92f1c4dc089f3
+  data.tar.gz: c1489640a38d8c4ee0e886ab0b311bb6ee1e7a2cfb06b71bdef2ef8a7b329d6d
 SHA512:
-  metadata.gz: 9c659fce767c7f9249f970a40d5fa1c627b151f2ef86990f676f8e50ddf2d9d398772389761e67ced5382b0640d69119be1fddf804b8fe7905814df55b659ec8
-  data.tar.gz: 41d93c9415d7352a35fe2e914784a1581c15dfd015e63f964d8b60be46c7334edfa69247f574075c111482ae37aa3e93bf9500441253019f910d9b85cd13a98b
+  metadata.gz: aac5e4ebc969fb723c24f48ba7f00e33b3b374df75816d4ce6c1af85278eff95575005a4c045a1c47c6ffa87cf4d1802e98a738af3860291e1b5f38bdaa57f1a
+  data.tar.gz: aa77ab523129a8419dc70f562915a2a78e8cd57dc9a6a64dbe29810131797a56ee66e7d92dda5d85dd903217128fe29202e44077b84d6e47da9bb99333fe6cd5

data/README.md

@@ -51,6 +51,11 @@ RailsActiveMcp.configure do |config|
   config.default_timeout = 30
   config.max_results = 100
 
+  # Server configuration
+  config.server_mode = :stdio # :stdio for Claude Desktop, :http for web
+  config.server_host = 'localhost'
+  config.server_port = 3001
+
   # Model access control
   config.allowed_models = %w[User Post Comment] # Empty = all allowed
   config.blocked_models = %w[AdminUser Secret]
@@ -64,6 +69,10 @@ RailsActiveMcp.configure do |config|
   config.production_mode! # Very strict
   config.strict_mode! # Safe defaults
   config.permissive_mode! # Development friendly
+  
+  # Server mode shortcuts
+  config.stdio_mode! # Set stdio mode for Claude Desktop
+  config.http_mode!(host: '0.0.0.0', port: 8080) # Set HTTP mode with custom host/port
 end
 ```
 
@@ -71,13 +80,18 @@ end
 
 You have several options for running the MCP server:
 
-### Option 1: Stdio server (recommended for Claude Desktop)
+### Option 1: Use configured mode (recommended)
 
 ```bash
-$ bundle exec rails-active-mcp-server stdio
+$ bundle exec rails-active-mcp-server
 ```
 
-This mode is required for Claude Desktop integration and other MCP clients that use stdio transport.
+This will use the server mode configured in your initializer (`:stdio` by default). You can override the mode:
+
+```bash
+$ bundle exec rails-active-mcp-server stdio  # Force stdio mode
+$ bundle exec rails-active-mcp-server http   # Force HTTP mode
+```
 
 ### Option 2: Rails-mounted (HTTP, good for development)
 

data/exe/rails-active-mcp-server

@@ -2,14 +2,32 @@
 # frozen_string_literal: true
 
 require 'rack'
-require 'rack/handler/webrick'
 require 'json'
 require_relative '../lib/rails_active_mcp'
 
-# Parse command line options
-transport = ARGV[0] || 'http'
-port = ARGV.include?('--port') ? ARGV[ARGV.index('--port') + 1].to_i : 3001
-host = ARGV.include?('--host') ? ARGV[ARGV.index('--host') + 1] : 'localhost'
+# Load Rails configuration if available
+require_relative '../config/environment' if File.exist?('config/environment.rb')
+
+# Parse command line options with config defaults
+default_mode = if defined?(RailsActiveMcp) && RailsActiveMcp.respond_to?(:config)
+                 RailsActiveMcp.config.server_mode.to_s
+               else
+                 'stdio'
+               end
+default_port = if defined?(RailsActiveMcp) && RailsActiveMcp.respond_to?(:config)
+                 RailsActiveMcp.config.server_port
+               else
+                 3001
+               end
+default_host = if defined?(RailsActiveMcp) && RailsActiveMcp.respond_to?(:config)
+                 RailsActiveMcp.config.server_host
+               else
+                 'localhost'
+               end
+
+transport = ARGV[0] || default_mode
+port = ARGV.include?('--port') ? ARGV[ARGV.index('--port') + 1].to_i : default_port
+host = ARGV.include?('--host') ? ARGV[ARGV.index('--host') + 1] : default_host
 
 case transport
 when 'stdio'
@@ -32,12 +50,19 @@ when 'http'
   puts 'Press Ctrl+C to stop'
 
   begin
+    require 'webrick'
+    require 'rack/handler/webrick'
+
     Rack::Handler::WEBrick.run(
       RailsActiveMcp::McpServer.new,
       Port: port,
       Host: host,
       Logger: WEBrick::Log.new(nil, WEBrick::BasicLog::WARN)
     )
+  rescue LoadError => e
+    puts 'Error: WEBrick not available. Please install: gem install webrick'
+    puts 'Or use stdio mode for Claude Desktop: rails-active-mcp-server stdio'
+    exit(1)
   rescue Interrupt
     puts "\nShutting down server..."
   end

data/lib/generators/rails_active_mcp/install/templates/README.md

@@ -12,20 +12,27 @@ Next Steps:
 
 1. Review and customize the configuration in config/initializers/rails_active_mcp.rb
 
-2. Start the MCP server:
-   Option A: Rails-mounted server (HTTP)
-   $ rails server
+2. Configure server mode in config/initializers/rails_active_mcp.rb:
+   config.server_mode = :stdio    # For Claude Desktop (default)
+   config.server_mode = :http     # For HTTP-based integrations
+   config.server_host = 'localhost'
+   config.server_port = 3001
 
-   Option B: Standalone HTTP server
-   $ bundle exec rails-active-mcp-server http
+3. Start the MCP server:
+   Option A: Use configured mode (RECOMMENDED)
+   $ bundle exec rails-active-mcp-server
 
-   Option C: Using rackup
-   $ rackup mcp.ru -p 3001
+   Option B: Override mode via command line
+   $ bundle exec rails-active-mcp-server stdio  # Force stdio mode
+   $ bundle exec rails-active-mcp-server http   # Force HTTP mode
 
-   Option D: Stdio server for Claude Desktop (RECOMMENDED)
-   $ bundle exec rails-active-mcp-server stdio
+   Option C: Rails-mounted server (HTTP)
+   $ rails server
+
+   Option D: Using rackup
+   $ rackup mcp.ru -p 3001
 
-3. For Claude Desktop integration, add this to your Claude Desktop configuration:
+4. For Claude Desktop integration, add this to your Claude Desktop configuration:
 
    Location: ~/.config/claude-desktop/claude_desktop_config.json (Linux/macOS)
    Location: %APPDATA%\Claude\claude_desktop_config.json (Windows)
@@ -52,7 +59,7 @@ Next Steps:
      }
    }
 
-4. For other MCP clients (HTTP-based), add this to your MCP configuration:
+5. For other MCP clients (HTTP-based), add this to your MCP configuration:
    {
      "mcpServers": {
        "rails-console": {
@@ -62,7 +69,7 @@ Next Steps:
      }
    }
 
-5. Test the installation:
+6. Test the installation:
    $ rails console
    > RailsActiveMcp.safe?("User.count")
    > RailsActiveMcp.execute("User.count")
@@ -85,6 +92,26 @@ Transport Modes:
 - stdio: For Claude Desktop and compatible MCP clients (recommended)
 - http: For HTTP-based integrations and web applications
 
+Configuration Examples:
+
+For Claude Desktop (default):
+  config.server_mode = :stdio
+
+For HTTP web integrations:
+  config.server_mode = :http
+  config.server_host = 'localhost'
+  config.server_port = 3001
+
+For Docker/remote access:
+  config.http_mode!(host: '0.0.0.0', port: 8080)
+
+For development with multiple transport modes:
+  if Rails.env.development?
+    config.stdio_mode!  # Claude Desktop
+  else
+    config.http_mode!(host: '0.0.0.0', port: 3001)  # Production HTTP
+  end
+
 Custom MCP Server Benefits:
 - No external dependencies
 - Full control over implementation

data/lib/generators/rails_active_mcp/install/templates/initializer.rb

@@ -1,6 +1,5 @@
 require 'rails_active_mcp'
 
-
 RailsActiveMcp.configure do |config|
   # Enable/disable the MCP server
   config.enabled = true
@@ -19,7 +18,12 @@ RailsActiveMcp.configure do |config|
 
   # Logging and auditing
   config.log_executions = true
-  config.audit_file = Rails.root.join("log", "rails_active_mcp.log")
+  config.audit_file = Rails.root.join('log', 'rails_active_mcp.log')
+
+  # Server configuration
+  config.server_mode = :stdio # :stdio for Claude Desktop, :http for web integrations
+  config.server_host = 'localhost'
+  config.server_port = 3001
 
   # Environment-specific settings
   case Rails.env
@@ -35,5 +39,5 @@ RailsActiveMcp.configure do |config|
   # config.add_safety_pattern(/CustomDangerousMethod/, "Custom dangerous operation")
 
   # Operations that require manual confirmation
-  config.require_confirmation_for = [:delete, :destroy, :update_all, :delete_all]
+  config.require_confirmation_for = %i[delete destroy update_all delete_all]
 end

data/lib/rails_active_mcp/configuration.rb

@@ -5,7 +5,8 @@ module RailsActiveMcp
     attr_accessor :enabled, :safe_mode, :default_timeout, :max_results,
                   :allowed_models, :blocked_models, :custom_safety_patterns,
                   :log_executions, :audit_file, :enable_mutation_tools,
-                  :require_confirmation_for, :execution_environment
+                  :require_confirmation_for, :execution_environment, :server_mode,
+                  :server_host, :server_port
 
     def initialize
       @enabled = true
@@ -17,10 +18,16 @@ module RailsActiveMcp
       @custom_safety_patterns = []
       @log_executions = true
       # Safe Rails.root access
-      @audit_file = rails_root_join("log", "rails_active_mcp.log") if defined?(Rails) && Rails.respond_to?(:root) && Rails.root
+      if defined?(Rails) && Rails.respond_to?(:root) && Rails.root
+        @audit_file = rails_root_join('log',
+                                      'rails_active_mcp.log')
+      end
       @enable_mutation_tools = false
-      @require_confirmation_for = [:delete, :destroy, :update_all, :delete_all]
+      @require_confirmation_for = %i[delete destroy update_all delete_all]
       @execution_environment = :current # :current, :sandbox, :readonly_replica
+      @server_mode = :stdio # :stdio, :http
+      @server_host = 'localhost'
+      @server_port = 3001
     end
 
     # Safety configuration
@@ -42,7 +49,7 @@ module RailsActiveMcp
       strict_mode!
       @execution_environment = :readonly_replica
       @log_executions = true
-      @require_confirmation_for = [:delete, :destroy, :update, :create, :save]
+      @require_confirmation_for = %i[delete destroy update create save]
     end
 
     # Model access configuration
@@ -58,6 +65,21 @@ module RailsActiveMcp
       @custom_safety_patterns << { pattern: pattern, description: description }
     end
 
+    # Server configuration
+    def stdio_mode!
+      @server_mode = :stdio
+    end
+
+    def http_mode!(host: 'localhost', port: 3001)
+      @server_mode = :http
+      @server_host = host
+      @server_port = port
+    end
+
+    def server_mode_valid?
+      %i[stdio http].include?(@server_mode)
+    end
+
     # Validation
     def model_allowed?(model_name)
       model_str = model_name.to_s
@@ -73,13 +95,15 @@ module RailsActiveMcp
     end
 
     def validate!
-      raise ArgumentError, "timeout must be positive" if @default_timeout <= 0
-      raise ArgumentError, "max_results must be positive" if @max_results <= 0
+      raise ArgumentError, 'timeout must be positive' if @default_timeout <= 0
+      raise ArgumentError, 'max_results must be positive' if @max_results <= 0
+      raise ArgumentError, "invalid server_mode: #{@server_mode}" unless server_mode_valid?
+      raise ArgumentError, 'server_port must be positive' if @server_port <= 0
 
-      if defined?(Rails) && @audit_file
-        audit_dir = File.dirname(@audit_file)
-        FileUtils.mkdir_p(audit_dir) unless File.directory?(audit_dir)
-      end
+      return unless defined?(Rails) && @audit_file
+
+      audit_dir = File.dirname(@audit_file)
+      FileUtils.mkdir_p(audit_dir) unless File.directory?(audit_dir)
     end
 
     private

data/lib/rails_active_mcp/version.rb

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

data/rails_active_mcp.gemspec

@@ -37,6 +37,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'json', '~> 2.0'
   spec.add_dependency 'rack', '~> 3.0'
   spec.add_dependency 'timeout', '~> 0.4'
+  spec.add_dependency 'webrick', '~> 1.8'
 
   # Development dependencies - keep versions consistent with Gemfile
   spec.add_development_dependency 'factory_bot_rails', '~> 6.0'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-active-mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Brandyn Britton
@@ -79,6 +79,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: factory_bot_rails
   requirement: !ruby/object:Gem::Requirement