rails-mcp-server 1.2.0 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d223ba6b32da76211f1b0316c76156453acfc25f86a2b2750949b5747cf4c2b2
-  data.tar.gz: c3bfbaa694738d88186f761c6053edffed7324d3a68a9168c91b63757250ad49
+  metadata.gz: 74a6004be8b59bdcb7faf865784f2873a6d2cd4c7d7a4e2efd359c6a7f07a00a
+  data.tar.gz: ab9986826c087ccda8bad64e749ce3382e73b7a895e151318415951abc3f0b95
 SHA512:
-  metadata.gz: '08cf5e172f3ad00d8e8fbcca061bd5c06fd3a6dfcac6610849f3cf9dda86a10a4bfa6c254804309e421bc64370382fe4a90e0456b82c3aa1aa14214d5f0a8be8'
-  data.tar.gz: 6c8a18e379e46f5c3a55554f244b48b1f01477dc1283911f198c0876cbeeaa6fccb8dccb6a972cdc2a7a218b42a8e07e9928a3a2d8a457eafad4b33f625e995d
+  metadata.gz: 8b1b210dd639c42add909b9b406de1fd5b9d82404df40cd8416320173e31f95adb41d1390a3c50f758c6c57acfc9d213200045e0d4ae3907cd217d458f54f86e
+  data.tar.gz: 51892b54ef22115b922d69bf71d0f34f0809fc58b949ddb2c3afaf521c87b7ae71cd5ef2575bc3347af6252d012bb3ab4a650fbe0a44d29dfd08d0b837dfd937

data/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.2] - 2025-07-21
+
+### Added
+
+- **Network Access Support**: New `--bind-all` flag for HTTP mode to allow access from local network
+  - Binds to `0.0.0.0` instead of `localhost` when enabled
+  - Allows connections from local network IP ranges (192.168.x.x, 10.x.x.x)
+  - Accepts connections from `.local` domain names (e.g., `my-computer.local`)
+  - Maintains security features with origin validation and IP filtering
+
+### Improved
+
+- **Security Configuration**: Enhanced allowed origins and IP configuration when using `--bind-all`
+  - Automatically configures appropriate security settings for local network access
+  - Preserves localhost-only mode by default for security
+  - Clear documentation of security implications
+
+### Changed
+
+- HTTP server binding address is now configurable via `--bind-all` flag
+- Updated help text to include new network access option
+
+## [1.2.1] - 2025-06-09
+
+### Fixed
+
+- Fix a debug message generating invalid STDIO output.
+- Fix tool name spelling.
+
 ## [1.2.0] - 2025-06-03
 
 ### Added
@@ -114,7 +143,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `list_files`: Browse project files with glob pattern matching
   - `get_file`: Retrieve file contents with syntax highlighting
   - `get_routes`: Display all Rails routes (equivalent to `rails routes`)
-  - `analize_models`: Analyze Active Record models, associations, and relationships
+  - `analyze_models`: Analyze Active Record models, associations, and relationships
   - `get_schema`: Retrieve database schema information and table structures
   - Basic file and project analysis capabilities
 - **Project Management System**:
@@ -163,6 +192,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version History Summary
 
+- **v1.2.2** (2025-07-21): Network access support with --bind-all flag
+- **v1.2.1** (2025-06-09): Bug fixes for STDIO output and tool naming
 - **v1.2.0** (2025-06-03): Major documentation and resource system addition
 - **v1.1.4** (2025-05-02): Critical bug fixes for HTTP mode and Rails commands
 - **v1.1.0** (2025-04-20): HTTP SSE support and new analysis tools with FastMCP migration
@@ -183,9 +214,9 @@ This project follows [Semantic Versioning](https://semver.org/):
 1. Update version in `lib/rails-mcp-server/version.rb`
 2. Update this CHANGELOG.md with new features and changes
 3. Update README.md and documentation if needed
-4. Create a git tag: `git tag -a v1.2.0 -m "Release version 1.2.0"`
+4. Create a git tag: `git tag -a v1.2.2 -m "Release version 1.2.2"`
 5. Push tags: `git push origin --tags`
-6. Build and publish gem: `gem build rails-mcp-server.gemspec && gem push rails-mcp-server-1.2.0.gem`
+6. Build and publish gem: `gem build rails-mcp-server.gemspec && gem push rails-mcp-server-1.2.2.gem`
 
 ### Changelog Categories
 

data/README.md

@@ -70,6 +70,9 @@ rails-mcp-server --mode http
 
 # Start in HTTP mode on a custom port
 rails-mcp-server --mode http -p 8080
+
+# Start in HTTP mode binding to all interfaces (for local network access)
+rails-mcp-server --mode http --bind-all
 ```
 
 When running in HTTP mode, the server provides two endpoints:
@@ -77,6 +80,27 @@ When running in HTTP mode, the server provides two endpoints:
 - JSON-RPC endpoint: `http://localhost:<port>/mcp/messages`
 - SSE endpoint: `http://localhost:<port>/mcp/sse`
 
+### Network Access (HTTP Mode)
+
+By default, the HTTP server only binds to localhost for security. If you need to access the server from other machines on your local network (e.g., for testing with multiple devices), you can use the `--bind-all` flag:
+
+```bash
+# Allow access from any machine on your local network
+rails-mcp-server --mode http --bind-all
+
+# With a custom port
+rails-mcp-server --mode http --bind-all -p 8080
+```
+
+When using `--bind-all`:
+
+- The server binds to `0.0.0.0` instead of `localhost`
+- Access is allowed from local network IP ranges (192.168.x.x, 10.x.x.x)
+- The server accepts connections from `.local` domain names (e.g., `my-computer.local`)
+- Security features remain active to prevent unauthorized access
+
+**Security Note**: Only use `--bind-all` on trusted networks. The server includes built-in security features to validate origins and IP addresses, but exposing any service to your network increases the attack surface.
+
 ### Logging Options
 
 The server logs to a file in the `./log` directory by default. You can customize logging with these options:
@@ -137,10 +161,17 @@ After running the script, restart Claude Desktop to apply the changes.
 
 Claude Desktop launches the MCP server using your system's default Ruby environment, bypassing version manager initialization (e.g., rbenv, RVM). The MCP server needs to use the same Ruby version where it was installed, as MCP server startup failures can occur when using an incompatible Ruby version.
 
-If you are using a Ruby version manager such as rbenv, you can create a symbolic link to your Ruby shim to ensure the correct version is used:
+If you are using a Ruby version manager such as rbenv, you can use the Ruby shim path to ensure the correct version is used:
 
-```bash
-sudo ln -s /home/your_user/.rbenv/shims/ruby /usr/local/bin/ruby
+```json
+{
+  "mcpServers": {
+    "railsMcpServer": {
+      "command": "/home/your_user/.rbenv/shims/ruby",
+      "args": ["/full/path/to/rails-mcp-server/exe/rails-mcp-server"] 
+    }
+  }
+}
 ```
 
 Replace "/home/your_user/.rbenv/shims/ruby" with your actual path for the Ruby shim.
@@ -308,7 +339,7 @@ I need to understand the API endpoints available in this project. Can you list t
 Show me the routing configuration for this Rails app so I can see how the URLs are structured.
 ```
 
-### 6. `analize_models`
+### 6. `analyze_models`
 
 **Description:** Retrieve detailed information about Active Record models in the project. When called without parameters, lists all model files. When a specific model is specified, returns its schema, associations (has_many, belongs_to, has_one), and complete source code.
 

data/exe/rails-mcp-server

@@ -13,9 +13,6 @@ require "puma/configuration"
 require "puma/launcher"
 require_relative "../lib/rails_mcp_server"
 
-# Debug information
-puts "Extensions loaded: #{RailsMcpServer.extensions_loaded?}\n\n"
-
 if ARGV[0] == "version"
   puts "Rails MCP Server version #{RailsMcpServer::VERSION}"
   exit 0
@@ -31,11 +28,13 @@ if ARGV[0] == "--help" || ARGV[0] == "-h"
   puts "  --log-level LEVEL      Log level: debug, info, warn, error (default: info)"
   puts "  --mode MODE            Server mode: http or stdio (default: stdio)"
   puts "  -p, --port PORT        Port to listen on (default: 6029)"
+  puts "  --bind-all             Bind to 0.0.0.0 instead of localhost (HTTP mode only)"
   puts "  version                Display version information"
   puts "  --help, -h             Display this help message"
   puts ""
   puts "Example:"
   puts "  #{File.basename($0)} --log-level debug -p 6060"
+  puts "  #{File.basename($0)} --mode http --bind-all"
   puts "  #{File.basename($0)} --mode stdio"
   exit 0
 end
@@ -43,6 +42,7 @@ end
 # Default values
 port = 6029
 mode = "stdio"
+bind_all = false
 
 # Parse command-line arguments
 i = 0
@@ -61,6 +61,9 @@ while i < ARGV.length
       exit 1
     end
     i += 2
+  when "--bind-all"
+    bind_all = true
+    i += 1
   else
     i += 1
   end
@@ -84,10 +87,12 @@ end
 
 case mode
 when "http"
-  puts "Starting Rack application with MCP middleware on http://localhost:#{port}"
+  bind_address = bind_all ? "0.0.0.0" : "localhost"
+
+  puts "Starting Rack application with MCP middleware on http://#{bind_address}:#{port}"
   puts "MCP endpoints:"
-  puts "  - http://localhost:#{port}/mcp/sse (SSE endpoint)"
-  puts "  - http://localhost:#{port}/mcp/messages (JSON-RPC endpoint)"
+  puts "  - http://#{bind_address}:#{port}/mcp/sse (SSE endpoint)"
+  puts "  - http://#{bind_address}:#{port}/mcp/messages (JSON-RPC endpoint)"
   puts ""
   puts "Version #{RailsMcpServer::VERSION}"
   puts ""
@@ -99,12 +104,15 @@ when "http"
   mcp_app = FastMcp.rack_middleware(
     rack_app,
     name: "rails-mcp-server", version: RailsMcpServer::VERSION,
+    allowed_origins: bind_all ? ["127.0.0.1", "localhost"] : ["127.0.0.1", "localhost", /.*\.local$/],
+    localhost_only: !bind_all,
+    allowed_ips: bind_all ? ["192.168.68.0/24", "10.0.0.0/8"] : ["127.0.0.1", "::1"],
     logger: RailsMcpServer.logger
   ) { |server| setup_mcp_tools(server) }
 
   app = Rack::Builder.new { run mcp_app }
   config = Puma::Configuration.new do |user_config|
-    user_config.bind "tcp://localhost:#{port}"
+    user_config.bind "tcp://#{bind_address}:#{port}"
     user_config.app app
   end
 

data/lib/rails-mcp-server/tools/analyze_models.rb

@@ -1,6 +1,6 @@
 module RailsMcpServer
   class AnalyzeModels < BaseTool
-    tool_name "analize_models"
+    tool_name "analyze_models"
 
     description "Retrieve detailed information about Active Record models in the project. When called without parameters, lists all model files. When a specific model is specified, returns its schema, associations (has_many, belongs_to, has_one), and complete source code."
 

data/lib/rails-mcp-server/version.rb

@@ -1,3 +1,3 @@
 module RailsMcpServer
-  VERSION = "1.2.0"
+  VERSION = "1.2.2"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rails-mcp-server
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.2
 platform: ruby
 authors:
 - Mario Alberto Chávez Cárdenas
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -98,8 +98,8 @@ email:
 - mario.chavez@gmail.com
 executables:
 - rails-mcp-server
-- rails-mcp-server-download-resources
 - rails-mcp-setup-claude
+- rails-mcp-server-download-resources
 extensions: []
 extra_rdoc_files: []
 files:
@@ -171,7 +171,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.2
 specification_version: 4
 summary: MCP server for Rails projects
 test_files: []