Bump version to 1.5.1 with relaxed dependency constraints

Loosen minor version locks in gemspec (logger, puma, rack) to allow compatible patch updates. Update Gemfile.lock with the latest dependencies.

1.4.1 Fix rails-mcp-config silent failure with rbenv shims

Fixed silent failure when running via rbenv shims

1.4.0 Context-efficient architecture with progressive tool discovery

This major release reduces initial context consumption by 67% through a new progressive tool discovery architecture, based on Anthropic's MCP best practices.

Highlights

Context-Efficient Architecture

• Reduced registered MCP tools from 12 to 4 bootstrap tools
• 9 internal analyzers discovered on-demand via search_tools and invoked via execute_tool
• Significantly reduces token usage when working with AI assistants

Sandboxed Ruby Execution

New execute_ruby tool allows secure code execution in Rails context with:

• File/network/system call restrictions
• Sensitive file protection (.env, credentials, .gitignore'd files)
• Helper methods: read_file, file_exists?, list_files, project_root

Interactive Configuration Tool

New rails-mcp-config TUI for:

• Project management with validation
• Guide downloading with progress indicators
• Claude Desktop auto-configuration (STDIO/HTTP modes)
• Gum-enhanced UI with terminal fallback

Rails Introspection (replaces regex parsing)

• Uses actual Rails APIs (reflect_on_all_associations, validators, action_methods)
• More accurate model and controller analysis
• Prism-based static analysis for callbacks, scopes, and concerns

Output Optimization

• New detail_level parameter: names | summary | full
• Route filtering by controller, verb, or path
• Batch operations for models and schemas

Full Changelog

See CHANGELOG.md for complete details.

1.2.3 Setup script fix

This release fixes rails-mcp-setup-claude failing on read-only filesystems (such as NixOS) or when the user is not the owner of the executable.

Thanks to @emptyflask for this contribution!

1.2.1 Bug fixing

This release fixes a bug that generated invalid JSON when connecting via STDIO.

Rails MCP Server: Enhanced Documentation Access

Added

• Comprehensive Resources and Documentation System: Complete access to Rails ecosystem documentation
  • load_guide tool for accessing official framework documentation
  • Support for Rails, Turbo, Stimulus, and Kamal documentation
  • Custom markdown file import capabilities
  • Automatic resource downloading via rails-mcp-server-download-resources command
  • Resource storage in XDG-compliant directories with manifest tracking
• Five Resource Categories:
  • Rails Guides: Official Ruby on Rails 8.0.2 documentation (50+ guides)
  • Turbo Guides: Complete Hotwire Turbo framework documentation
  • Stimulus Guides: Full Stimulus JavaScript framework documentation
  • Kamal Guides: Comprehensive Kamal deployment tool documentation
  • Custom Guides: Import and manage your own markdown documentation
• Direct Resource Access: MCP clients can query resources using URI templates
  • rails://guides/{guide_name} for Rails documentation
  • turbo://guides/{guide_name} for Turbo guides
  • stimulus://guides/{guide_name} for Stimulus documentation
  • kamal://guides/{guide_name} for Kamal guides
  • custom://guides/{guide_name} for custom imports
• Advanced Resource Management:
  • Force download options (--force) for updating resources
  • Verbose logging (--verbose) for troubleshooting
  • Batch import support for directory structures
  • Filename normalization for custom imports
  • Version tracking and update management

Improved

• Enhanced Documentation: All tools now include comprehensive natural language examples
• Resource Integration: Seamless integration with existing MCP tool ecosystem
• File Organization: Better project structure with XDG Base Directory compliance
• Error Handling: Improved validation and error messages across resource operations

Technical

• URI templating support for direct resource access
• Enhanced manifest management for resource tracking
• Integration with FastMCP for robust resource handling
• Simplified guides configuration and management

Fixes for HTTP mode and calling rails commands

• Fixes an issue that prevented the Puma server to start in HTTP mode
• Fixes an issue when calling a rails command

Fix dependencies versions

Before this change, the gem did not specify dependency versions. As a result, each installation could pull different versions of dependencies—older or newer—which could lead to unpredictable or erratic behavior in the server.