SSH Rails Runner

What it does

SSH Rails Runner connects your AI coding agent to a deployed Rails application via SSH, letting it execute Ruby/Rails console commands remotely. Instead of wrestling with complex admin UIs for data wrangling and analysis, you can pull in your Rails model files as context and query or mutate your production database directly from Cursor Composer or Claude Desktop.

Tools

• mcp_ssh_rails_runner_prepare_code_snippet — Saves Ruby code to a local file and opens it for human review before execution. Marks snippets as readOnly or mutate.
• mcp_ssh_rails_runner_execute_code_snippet_read_only — Executes a reviewed read-only snippet via SSH Rails console. Includes safety checks.
• mcp_ssh_rails_runner_execute_code_snippet_mutate — Executes a mutation snippet. Only callable after explicit user confirmation of the prepared code.
• mcp_ssh_rails_runner_get_all_code_snippets — Lists all saved code snippets.
• mcp_ssh_rails_runner_get_code_snippet — Retrieves a specific snippet by URI.

Installation

Install via npm, then add to your Claude Desktop config:

{
  "mcpServers": {
    "ssh-rails-runner": {
      "command": "npx",
      "args": ["mcp-server-ssh-rails-runner"],
      "env": {
        "SSH_HOST": "your.remote.host",
        "SSH_USER": "your_ssh_user",
        "SSH_PRIVATE_KEY_PATH": "/path/to/private/key",
        "RAILS_WORKING_DIR": "/path/to/rails/app/root",
        "PROJECT_NAME_AS_CONTEXT": "My Rails App",
        "CODE_SNIPPET_FILE_DIRECTORY": "/tmp/mcp-snippets"
      }
    }
  }
}

For Cursor, add the same block to your ~/.cursor/mcp.json file.

Supported hosts

Claude Desktop and Cursor are confirmed. Any MCP-compatible client supporting stdio transport should work.