rails-active-mcp 0.1.7 → 2.0.8

data/rails_active_mcp.gemspec

@@ -8,23 +8,51 @@ Gem::Specification.new do |spec|
   spec.authors = ['Brandyn Britton']
   spec.email = ['brandynbb96@gmail.com']
 
-  spec.summary = 'Rails Console access via Model Context Protocol (MCP)'
-  spec.description = 'Secure Rails console access for AI agents through Model Context Protocol with safety features and read-only modes'
+  spec.summary = 'Secure Rails console access via Model Context Protocol (MCP)'
+  spec.description = <<~DESC
+    Rails Active MCP enables secure Rails console access through Model Context Protocol (MCP)#{' '}
+    for AI agents and development tools like Claude Desktop. Provides safe database querying,#{' '}
+    model introspection, and code execution with comprehensive safety checks and audit logging.
+
+    Features include:
+    • Safe Ruby code execution with configurable safety checks
+    • Read-only database query tools with result limiting
+    • Rails model introspection (schema, associations, validations)
+    • Dry-run code analysis for safety validation
+    • Environment-specific configuration presets
+    • Comprehensive audit logging and monitoring
+    • Claude Desktop integration out of the box
+  DESC
+
   spec.homepage = 'https://github.com/goodpie/rails-active-mcp'
   spec.license = 'MIT'
   spec.required_ruby_version = '>= 3.0.0'
 
-  spec.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = spec.homepage
-  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata = {
+    'homepage_uri' => spec.homepage,
+    'source_code_uri' => "#{spec.homepage}/tree/main",
+    'changelog_uri' => "#{spec.homepage}/blob/main/changelog.md",
+    'bug_tracker_uri' => "#{spec.homepage}/issues",
+    'documentation_uri' => "#{spec.homepage}#readme",
+    'wiki_uri' => "#{spec.homepage}/wiki",
+    'mailing_list_uri' => "#{spec.homepage}/discussions",
+    'funding_uri' => 'https://github.com/sponsors/goodpie',
+    'rubygems_mfa_required' => 'true'
+  }
 
-  # Specify which files should be added to the gem when it is released.
+  # Specify which files should be added to the gem when it is released
   spec.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject do |f|
       (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile]) ||
+        f.match?(%r{\A(?:log|tmp|\.)/}) ||
+        f.end_with?('.log', '.tmp')
     end
-  end
+  end + [
+    'examples/rails_app_integration.md',
+    'docs/DEBUGGING.md',
+    'docs/README.md'
+  ].select { |f| File.exist?(f) }
 
   spec.bindir = 'exe'
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
@@ -32,7 +60,10 @@ Gem::Specification.new do |spec|
 
   # Runtime dependencies - more flexible Rails version support
   spec.add_runtime_dependency 'concurrent-ruby', '~> 1.3'
-  spec.add_runtime_dependency 'rails', '>= 6.1', '< 8.0'
+  spec.add_runtime_dependency 'rails', '>= 6.1', '< 9.0'
+
+  # MCP SDK - Core protocol implementation
+  spec.add_runtime_dependency 'mcp', '~> 0.1.0'
 
   # Core dependencies
   spec.add_dependency 'json', '~> 2.0'
@@ -41,11 +72,31 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'webrick', '~> 1.8'
 
   # Development dependencies - keep versions consistent with Gemfile
+  spec.add_development_dependency 'colorize', '~> 0.8'
   spec.add_development_dependency 'factory_bot_rails', '~> 6.0'
+  spec.add_development_dependency 'faker', '~> 2.19'
   spec.add_development_dependency 'rspec', '~> 3.1'
-  spec.add_development_dependency 'rspec-rails'
+  spec.add_development_dependency 'rspec-rails', '~> 6.0'
   spec.add_development_dependency 'rubocop', '~> 1.77'
   spec.add_development_dependency 'rubocop-rails', '~> 2.32'
-  spec.add_development_dependency 'rubocop-rspec'
+  spec.add_development_dependency 'rubocop-rspec', '~> 3.0'
   spec.add_development_dependency 'sqlite3', '~> 2.7'
+
+  # Post-install message to help users get started
+  spec.post_install_message = <<~MSG
+
+    🎉 Thanks for installing Rails Active MCP!
+
+    Quick Start:
+    1. Add to your Rails app: rails generate rails_active_mcp:install
+    2. Test the setup: rails rails_active_mcp:status
+    3. Configure Claude Desktop: rails rails_active_mcp:install_claude_config
+
+    📚 Documentation: #{spec.homepage}#readme
+    🐛 Issues: #{spec.homepage}/issues
+    💬 Discussions: #{spec.homepage}/discussions
+
+    Follow the project: ⭐ #{spec.homepage}
+
+  MSG
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-active-mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 2.0.8
 platform: ruby
 authors:
 - Brandyn Britton
@@ -32,7 +32,7 @@ dependencies:
         version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '9.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -42,7 +42,21 @@ dependencies:
         version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -105,6 +119,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: factory_bot_rails
   requirement: !ruby/object:Gem::Requirement
@@ -119,6 +147,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -137,16 +179,16 @@ dependencies:
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -179,16 +221,16 @@ dependencies:
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -203,8 +245,14 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.7'
-description: Secure Rails console access for AI agents through Model Context Protocol
-  with safety features and read-only modes
+description: "Rails Active MCP enables secure Rails console access through Model Context
+  Protocol (MCP) \nfor AI agents and development tools like Claude Desktop. Provides
+  safe database querying, \nmodel introspection, and code execution with comprehensive
+  safety checks and audit logging.\n\nFeatures include:\n• Safe Ruby code execution
+  with configurable safety checks\n• Read-only database query tools with result limiting\n•
+  Rails model introspection (schema, associations, validations)\n• Dry-run code analysis
+  for safety validation\n• Environment-specific configuration presets\n• Comprehensive
+  audit logging and monitoring\n• Claude Desktop integration out of the box\n"
 email:
 - brandynbb96@gmail.com
 executables:
@@ -218,13 +266,14 @@ files:
 - ".idea/rails-active-mcp-gem.iml"
 - ".idea/vcs.xml"
 - README.md
-- app/controllers/rails_active_mcp/mcp_controller.rb
 - changelog.md
 - claude_desktop_config.json
 - docs/DEBUGGING.md
 - docs/GENERATOR_TESTING.md
 - docs/README.md
+- examples/rails_app_integration.md
 - exe/rails-active-mcp-server
+- gemfiles/rails_7.1.gemfile
 - lib/generators/rails_active_mcp/install/install_generator.rb
 - lib/generators/rails_active_mcp/install/templates/README.md
 - lib/generators/rails_active_mcp/install/templates/initializer.rb
@@ -233,15 +282,13 @@ files:
 - lib/rails_active_mcp/configuration.rb
 - lib/rails_active_mcp/console_executor.rb
 - lib/rails_active_mcp/engine.rb
-- lib/rails_active_mcp/mcp_server.rb
-- lib/rails_active_mcp/railtie.rb
 - lib/rails_active_mcp/safety_checker.rb
-- lib/rails_active_mcp/stdio_server.rb
+- lib/rails_active_mcp/sdk/server.rb
+- lib/rails_active_mcp/sdk/tools/console_execute_tool.rb
+- lib/rails_active_mcp/sdk/tools/dry_run_tool.rb
+- lib/rails_active_mcp/sdk/tools/model_info_tool.rb
+- lib/rails_active_mcp/sdk/tools/safe_query_tool.rb
 - lib/rails_active_mcp/tasks.rake
-- lib/rails_active_mcp/tools/console_execute_tool.rb
-- lib/rails_active_mcp/tools/dry_run_tool.rb
-- lib/rails_active_mcp/tools/model_info_tool.rb
-- lib/rails_active_mcp/tools/safe_query_tool.rb
 - lib/rails_active_mcp/version.rb
 - mcp.ru
 - rails_active_mcp.gemspec
@@ -250,8 +297,20 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/goodpie/rails-active-mcp
-  source_code_uri: https://github.com/goodpie/rails-active-mcp
-  changelog_uri: https://github.com/goodpie/rails-active-mcp/blob/main/CHANGELOG.md
+  source_code_uri: https://github.com/goodpie/rails-active-mcp/tree/main
+  changelog_uri: https://github.com/goodpie/rails-active-mcp/blob/main/changelog.md
+  bug_tracker_uri: https://github.com/goodpie/rails-active-mcp/issues
+  documentation_uri: https://github.com/goodpie/rails-active-mcp#readme
+  wiki_uri: https://github.com/goodpie/rails-active-mcp/wiki
+  mailing_list_uri: https://github.com/goodpie/rails-active-mcp/discussions
+  funding_uri: https://github.com/sponsors/goodpie
+  rubygems_mfa_required: 'true'
+post_install_message: "\n\U0001F389 Thanks for installing Rails Active MCP!\n\nQuick
+  Start:\n1. Add to your Rails app: rails generate rails_active_mcp:install\n2. Test
+  the setup: rails rails_active_mcp:status\n3. Configure Claude Desktop: rails rails_active_mcp:install_claude_config\n\n\U0001F4DA
+  Documentation: https://github.com/goodpie/rails-active-mcp#readme\n\U0001F41B Issues:
+  https://github.com/goodpie/rails-active-mcp/issues\n\U0001F4AC Discussions: https://github.com/goodpie/rails-active-mcp/discussions\n\nFollow
+  the project: ⭐ https://github.com/goodpie/rails-active-mcp\n\n"
 rdoc_options: []
 require_paths:
 - lib
@@ -268,5 +327,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.2
 specification_version: 4
-summary: Rails Console access via Model Context Protocol (MCP)
+summary: Secure Rails console access via Model Context Protocol (MCP)
 test_files: []

data/app/controllers/rails_active_mcp/mcp_controller.rb

@@ -1,80 +0,0 @@
-# frozen_string_literal: true
-
-module RailsActiveMcp
-  class McpController < ApplicationController
-    protect_from_forgery with: :null_session
-    before_action :check_enabled
-    before_action :set_cors_headers
-
-    def handle
-      return head :method_not_allowed unless request.post?
-      return head :bad_request unless json_request?
-
-      begin
-        body = request.body.read
-        data = JSON.parse(body)
-
-        mcp_server = RailsActiveMcp::McpServer.new
-        response_data = mcp_server.handle_jsonrpc_request(data)
-
-        render json: response_data
-      rescue JSON::ParserError
-        render json: { error: 'Invalid JSON' }, status: :bad_request
-      rescue StandardError => e
-        RailsActiveMcp.logger.error "MCP Controller Error: #{e.message}"
-        render json: { error: 'Internal Server Error' }, status: :internal_server_error
-      end
-    end
-
-    def sse
-      response.headers['Content-Type'] = 'text/event-stream'
-      response.headers['Cache-Control'] = 'no-cache, no-store, must-revalidate'
-      response.headers['Connection'] = 'keep-alive'
-      response.headers['X-Accel-Buffering'] = 'no'
-
-      # Send initial connection established event
-      render plain: ": SSE connection established\n\nevent: endpoint\ndata: #{request.base_url}#{rails_active_mcp.root_path}messages\n\nretry: 100\n\n"
-    end
-
-    def health
-      status = RailsActiveMcp.config.enabled ? 'healthy' : 'disabled'
-      render json: {
-        status: status,
-        version: RailsActiveMcp::VERSION,
-        timestamp: Time.current.iso8601
-      }
-    end
-
-    def info
-      render json: {
-        name: 'Rails Active MCP',
-        version: RailsActiveMcp::VERSION,
-        description: 'Rails Console access via Model Context Protocol (MCP)',
-        endpoints: {
-          mcp: rails_active_mcp.root_path,
-          health: rails_active_mcp.root_path + 'health'
-        },
-        enabled: RailsActiveMcp.config.enabled
-      }
-    end
-
-    private
-
-    def check_enabled
-      return if RailsActiveMcp.config.enabled
-
-      render json: { error: 'Rails Active MCP is disabled' }, status: :service_unavailable
-    end
-
-    def json_request?
-      request.content_type&.include?('application/json')
-    end
-
-    def set_cors_headers
-      response.headers['Access-Control-Allow-Origin'] = '*'
-      response.headers['Access-Control-Allow-Methods'] = 'GET, POST, OPTIONS'
-      response.headers['Access-Control-Allow-Headers'] = 'Content-Type'
-      response.headers['Access-Control-Max-Age'] = '86400'
-    end
-  end
-end