rails-dev-mcp 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 03307be97232cb5e690da0c582b6b14b374eac0525a596dfa89f57f1d3837cde
+  data.tar.gz: e83d66ea6c9591dd8a0ae1dac29de657417b4568ed217ab5c629f982fcc52382
+SHA512:
+  metadata.gz: 8851102c18771b9c8ae57fdab79ee6576fb2de3b10c7db58d76b472c69f23be8342b16b816a5816d92f357f17b9998a71e94ff6aa186b6aa7f5e214827aa6e59
+  data.tar.gz: 78b8495d4b67e0c9c32f2fada44851f2e131ec14ff580ff962f3a90b09128dcf20f2a2288ac3a33298309a625829a14f3004d424e79456ba76af799fb28b33d3

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Obie Fernandez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,126 @@
+# Rails Dev MCP
+
+A Model Context Protocol (MCP) server that allows AI agents to manage Rails development servers. Start, stop, and monitor your Rails app directly from Claude!
+
+## Features
+
+- **start_dev_server**: Start Rails development server on a specified port
+- **stop_dev_server**: Stop the running Rails server
+- **dev_server_logs**: View recent logs and notable events (errors, warnings, requests)
+- **dev_server_status**: Check if the server is running and get connection details
+
+## Installation
+
+### As a gem
+
+```bash
+gem install rails-dev-mcp
+```
+
+### From source
+
+```bash
+git clone https://github.com/obie/rails-dev-mcp.git
+cd rails-dev-mcp
+bundle install
+rake install
+```
+
+## Usage
+
+### With Claude Desktop
+
+Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "rails-dev": {
+      "command": "rails-dev-mcp",
+      "cwd": "/path/to/your/rails/project"
+    }
+  }
+}
+```
+
+### With ClaudeOnRails
+
+The Rails Dev MCP integrates seamlessly with ClaudeOnRails. Add to your `claude-swarm.yml`:
+
+```yaml
+mcps:
+  - name: rails-dev
+    type: stdio
+    command: rails-dev-mcp
+    args: []
+```
+
+## Available Tools
+
+### start_dev_server
+
+Starts the Rails development server.
+
+**Parameters:**
+- `port` (optional): Port number (default: 3000)
+
+**Example:**
+```
+Start the Rails server on port 3001
+```
+
+### stop_dev_server
+
+Stops the running Rails development server.
+
+**Example:**
+```
+Stop the Rails server
+```
+
+### dev_server_logs
+
+Retrieves recent logs from the Rails server.
+
+**Parameters:**
+- `lines` (optional): Number of log lines to retrieve (default: 50)
+- `notable_only` (optional): Show only errors, warnings, and requests
+
+**Example:**
+```
+Show me the last 100 lines from the Rails server logs
+Show me only errors from the Rails logs
+```
+
+### dev_server_status
+
+Checks the current status of the Rails development server.
+
+**Example:**
+```
+Is the Rails server running?
+```
+
+## How It Works
+
+1. **Process Management**: Uses Ruby's Open3 to manage the Rails server process
+2. **Log Capture**: Redirects server output to a log file for later retrieval
+3. **PID Tracking**: Maintains PID files to track running processes
+4. **Smart Log Filtering**: Identifies notable events like errors, warnings, and HTTP requests
+
+## Development
+
+```bash
+# Run tests
+bundle exec rspec
+
+# Run linter
+bundle exec rubocop
+
+# Build gem
+gem build rails-dev-mcp.gemspec
+```
+
+## License
+
+MIT License - see LICENSE file for details.

data/exe/rails-dev-mcp

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'rails_dev_mcp'
+
+RailsDevMCP::Server.new.run

data/lib/rails_dev_mcp/process_manager.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+require 'open3'
+require 'fileutils'
+
+module RailsDevMCP
+  class ProcessManager
+    attr_reader :pid, :log_file, :port
+
+    def initialize(rails_root:, port: 3000)
+      @rails_root = rails_root
+      @port = port
+      @log_file = File.join(rails_root, 'tmp', 'rails-dev-mcp.log')
+      @pid_file = File.join(rails_root, 'tmp', 'pids', 'rails-dev-mcp.pid')
+      @pid = nil
+      @stdin = nil
+      @stdout = nil
+      @stderr = nil
+      @wait_thread = nil
+      
+      ensure_directories
+    end
+
+    def start
+      return { success: false, error: 'Server already running' } if running?
+
+      # Start Rails server with output captured
+      cmd = "rails server -p #{@port}"
+      
+      @stdin, @stdout, @stderr, @wait_thread = Open3.popen3(
+        cmd,
+        chdir: @rails_root,
+        err: [:child, :out] # Combine stderr into stdout
+      )
+      
+      @pid = @wait_thread.pid
+      write_pid_file(@pid)
+
+      # Start log capture thread
+      Thread.new do
+        File.open(@log_file, 'a') do |log|
+          @stdout.each_line do |line|
+            log.puts(line)
+            log.flush
+          end
+        end
+      end
+
+      # Wait a moment to check if it started successfully
+      sleep 2
+      
+      if running?
+        { success: true, message: "Rails server started on port #{@port}", pid: @pid }
+      else
+        { success: false, error: 'Failed to start Rails server' }
+      end
+    rescue StandardError => e
+      { success: false, error: e.message }
+    end
+
+    def stop
+      return { success: false, error: 'Server not running' } unless running?
+
+      begin
+        Process.kill('TERM', @pid)
+        @wait_thread&.join(5) # Wait up to 5 seconds for graceful shutdown
+        
+        if running?
+          Process.kill('KILL', @pid) # Force kill if still running
+        end
+        
+        cleanup
+        { success: true, message: 'Rails server stopped' }
+      rescue Errno::ESRCH
+        # Process already dead
+        cleanup
+        { success: true, message: 'Rails server was already stopped' }
+      rescue StandardError => e
+        { success: false, error: e.message }
+      end
+    end
+
+    def logs(lines: 50)
+      return { success: false, error: 'Log file not found' } unless File.exist?(@log_file)
+
+      begin
+        log_content = `tail -n #{lines} #{@log_file}`
+        
+        # Extract notable events (errors, warnings, requests)
+        notable_lines = log_content.lines.select do |line|
+          line =~ /ERROR|WARN|FATAL|Started|Completed|ActionController::RoutingError|ActiveRecord::|NoMethodError|NameError|SyntaxError/
+        end
+
+        {
+          success: true,
+          full_logs: log_content,
+          notable_events: notable_lines.join,
+          log_file: @log_file
+        }
+      rescue StandardError => e
+        { success: false, error: e.message }
+      end
+    end
+
+    def status
+      if running?
+        {
+          running: true,
+          pid: @pid,
+          port: @port,
+          url: "http://localhost:#{@port}",
+          log_file: @log_file
+        }
+      else
+        {
+          running: false,
+          port: @port,
+          log_file: @log_file
+        }
+      end
+    end
+
+    def running?
+      return false unless @pid || read_pid_file
+
+      begin
+        Process.kill(0, @pid || read_pid_file)
+        true
+      rescue Errno::ESRCH
+        false
+      end
+    end
+
+    private
+
+    def ensure_directories
+      FileUtils.mkdir_p(File.dirname(@log_file))
+      FileUtils.mkdir_p(File.dirname(@pid_file))
+    end
+
+    def write_pid_file(pid)
+      File.write(@pid_file, pid.to_s)
+    end
+
+    def read_pid_file
+      return nil unless File.exist?(@pid_file)
+      File.read(@pid_file).to_i
+    rescue StandardError
+      nil
+    end
+
+    def cleanup
+      File.unlink(@pid_file) if File.exist?(@pid_file)
+      @stdin&.close
+      @stdout&.close
+      @stderr&.close
+      @pid = nil
+      @wait_thread = nil
+    end
+  end
+end

data/lib/rails_dev_mcp/server.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'fast_mcp'
+require 'logger'
+require 'forwardable'
+
+module RailsDevMCP
+  class Server
+    def run
+      server = FastMcp::Server.new(
+        name: 'rails-dev-mcp',
+        version: VERSION,
+        description: 'MCP server for managing Rails development servers'
+      )
+
+      # Register our tools
+      server.register_tools(
+        Tools::StartDevServer,
+        Tools::StopDevServer,
+        Tools::DevServerLogs,
+        Tools::DevServerStatus
+      )
+
+      # Start the server in STDIO mode
+      server.run
+    end
+  end
+
+  # Configuration module
+  module Config
+    class << self
+      attr_accessor :logger, :rails_root, :server_process
+
+      def setup(rails_root = Dir.pwd)
+        @logger = Logger.new($stderr)
+        @logger.level = Logger::INFO
+        @rails_root = rails_root
+        @server_process = nil
+        self
+      end
+    end
+  end
+
+  # Initialize configuration
+  @config = Config.setup
+
+  class << self
+    extend Forwardable
+    def_delegators :@config, :logger, :rails_root, :server_process, :server_process=
+
+    def log(level, message)
+      levels = { debug: Logger::DEBUG, info: Logger::INFO, warn: Logger::WARN, error: Logger::ERROR }
+      logger.add(levels[level] || Logger::INFO, message)
+    end
+  end
+end
+
+# Load tools after module is defined
+require_relative 'tools/base_tool'
+require_relative 'tools/start_dev_server'
+require_relative 'tools/stop_dev_server'
+require_relative 'tools/dev_server_logs'
+require_relative 'tools/dev_server_status'

data/lib/rails_dev_mcp/tools/base_tool.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'fast_mcp'
+require 'forwardable'
+
+module RailsDevMCP
+  module Tools
+    class BaseTool < FastMcp::Tool
+      extend Forwardable
+      def_delegators :RailsDevMCP, :log, :rails_root, :server_process
+    end
+  end
+end

data/lib/rails_dev_mcp/tools/dev_server_logs.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module RailsDevMCP
+  module Tools
+    class DevServerLogs < BaseTool
+      tool_name 'dev_server_logs'
+      
+      description 'Get latest logs from the Rails development server, highlighting notable events like errors and requests'
+      
+      argument :lines, type: 'integer', description: 'Number of log lines to retrieve (default: 50)', required: false
+      argument :notable_only, type: 'boolean', description: 'Show only notable events (errors, warnings, requests)', required: false
+
+      def call(lines: nil, notable_only: nil)
+        lines ||= 50
+        notable_only ||= false
+        
+        unless RailsDevMCP.server_process
+          # Try to read logs even if process not tracked
+          process = ProcessManager.new(rails_root: RailsDevMCP.rails_root)
+          result = process.logs(lines: lines)
+        else
+          result = RailsDevMCP.server_process.logs(lines: lines)
+        end
+        
+        if result[:success]
+          log(:debug, "Retrieved #{lines} log lines")
+          
+          if notable_only && result[:notable_events].to_s.strip.length > 0
+            <<~LOGS
+              📋 Notable events from Rails server logs:
+              
+              #{result[:notable_events]}
+              
+              Log file: #{result[:log_file]}
+            LOGS
+          elsif result[:full_logs].to_s.strip.length > 0
+            <<~LOGS
+              📋 Rails server logs (last #{lines} lines):
+              
+              #{result[:full_logs]}
+              
+              Log file: #{result[:log_file]}
+            LOGS
+          else
+            "📋 No logs available yet. The server may have just started."
+          end
+        else
+          log(:error, "Failed to retrieve logs: #{result[:error]}")
+          "❌ Failed to retrieve logs: #{result[:error]}"
+        end
+      end
+    end
+  end
+end

data/lib/rails_dev_mcp/tools/dev_server_status.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module RailsDevMCP
+  module Tools
+    class DevServerStatus < BaseTool
+      tool_name 'dev_server_status'
+      
+      description 'Check the status of the Rails development server'
+
+      def call
+        # Check for existing process or create new manager to check
+        process = RailsDevMCP.server_process || ProcessManager.new(rails_root: RailsDevMCP.rails_root)
+        status = process.status
+        
+        if status[:running]
+          <<~STATUS
+            🟢 Rails development server is running
+            
+            PID: #{status[:pid]}
+            Port: #{status[:port]}
+            URL: #{status[:url]}
+            Log file: #{status[:log_file]}
+          STATUS
+        else
+          <<~STATUS
+            🔴 Rails development server is not running
+            
+            Port: #{status[:port]} (configured)
+            Log file: #{status[:log_file]}
+            
+            Use 'start_dev_server' to start the server.
+          STATUS
+        end
+      end
+    end
+  end
+end

data/lib/rails_dev_mcp/tools/start_dev_server.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module RailsDevMCP
+  module Tools
+    class StartDevServer < BaseTool
+      tool_name 'start_dev_server'
+      
+      description 'Start the Rails development server'
+      
+      argument :port, type: 'integer', description: 'Port to run the server on (default: 3000)', required: false
+
+      def call(port: nil)
+        port ||= 3000
+        
+        # Create process manager if not exists
+        RailsDevMCP.server_process ||= ProcessManager.new(
+          rails_root: RailsDevMCP.rails_root,
+          port: port
+        )
+
+        result = RailsDevMCP.server_process.start
+        
+        if result[:success]
+          log(:info, "Rails server started: #{result[:message]}")
+          "✅ #{result[:message]}\nPID: #{result[:pid]}\nURL: http://localhost:#{port}"
+        else
+          log(:error, "Failed to start Rails server: #{result[:error]}")
+          "❌ Failed to start Rails server: #{result[:error]}"
+        end
+      end
+    end
+  end
+end

data/lib/rails_dev_mcp/tools/stop_dev_server.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module RailsDevMCP
+  module Tools
+    class StopDevServer < BaseTool
+      tool_name 'stop_dev_server'
+      
+      description 'Stop the Rails development server'
+
+      def call
+        unless RailsDevMCP.server_process
+          return "❌ No Rails server process found"
+        end
+
+        result = RailsDevMCP.server_process.stop
+        
+        if result[:success]
+          log(:info, "Rails server stopped: #{result[:message]}")
+          RailsDevMCP.server_process = nil
+          "✅ #{result[:message]}"
+        else
+          log(:error, "Failed to stop Rails server: #{result[:error]}")
+          "❌ Failed to stop Rails server: #{result[:error]}"
+        end
+      end
+    end
+  end
+end

data/lib/rails_dev_mcp/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RailsDevMCP
+  VERSION = '0.1.0'
+end

data/lib/rails_dev_mcp.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'rails_dev_mcp/version'
+require 'rails_dev_mcp/server'
+require 'rails_dev_mcp/process_manager'
+
+module RailsDevMCP
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: rails-dev-mcp
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Obie Fernandez
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-07-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fast-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+description: A Model Context Protocol (MCP) server that allows AI agents to start,
+  stop, and monitor Rails development servers
+email:
+- obiefernandez@gmail.com
+executables:
+- rails-dev-mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- LICENSE
+- README.md
+- exe/rails-dev-mcp
+- lib/rails_dev_mcp.rb
+- lib/rails_dev_mcp/process_manager.rb
+- lib/rails_dev_mcp/server.rb
+- lib/rails_dev_mcp/tools/base_tool.rb
+- lib/rails_dev_mcp/tools/dev_server_logs.rb
+- lib/rails_dev_mcp/tools/dev_server_status.rb
+- lib/rails_dev_mcp/tools/start_dev_server.rb
+- lib/rails_dev_mcp/tools/stop_dev_server.rb
+- lib/rails_dev_mcp/version.rb
+homepage: https://github.com/obie/rails-dev-mcp
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/obie/rails-dev-mcp
+  source_code_uri: https://github.com/obie/rails-dev-mcp
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: MCP server for managing Rails development servers
+test_files: []