MCP Server: SSH Rails Runner

@tadasant

Repository

Basic information

About MCP Server: SSH Rails Runner

MCP server that facilitates an SSH connection to a deployed Rails app so you can run Rails REPL commands

MCP Server: SSH Rails Runner config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

MCP Server: SSH Rails Runner tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server: SSH Rails Runner?

An MCP server that enables secure remote execution of Rails console commands via SSH. It provides tools for both read-only operations and carefully managed mutations in a deployed Rails environment. The server is designed to work with Cursor, allowing AI-assisted database changes through a Prepare → Execute workflow.

How to use MCP Server: SSH Rails Runner?

Install with npm install && npm run build, then configure environment variables SSH_HOST, SSH_USER, SSH_PRIVATE_KEY_PATH, and RAILS_WORKING_DIR. Optionally set PROJECT_NAME_AS_CONTEXT and CODE_SNIPPET_FILE_DIRECTORY. Add the server to Claude Desktop configuration using the npx mcp-server-ssh-rails-runner command. Use the three provided tools: prepare_code_snippet to save and review Ruby code, execute_code_snippet_read_only for safe read-only operations, and execute_code_snippet_mutate for approved mutations.

Key features of MCP Server: SSH Rails Runner

Remote Rails console execution over SSH
Safe read-only operations with safety checks
Dry-run capability for mutations
Prepare—Execute workflow for code snippets
Resource management for saved code snippets

Use cases of MCP Server: SSH Rails Runner

Performing read-only data analysis on a live Rails database via Cursor Composer
Applying user-confirmed database mutations after reviewing prepared code snippets
Automating complex Rails console tasks without manual SSH login
Integrating AI coding assistants with remote Rails environments

Frequently asked questions

What transport or authentication does the server use?

It uses SSH authentication via a private key, configured through `SSH_USER`, `SSH_HOST`, and `SSH_PRIVATE_KEY_PATH` environment variables.

Where are code snippets stored?

By default in a temporary directory (`/tmp/mcp-ssh-rails-runner-code-snippets`). You can set `CODE_SNIPPET_FILE_DIRECTORY` to a custom path.

How does the server prevent accidental mutations?

It uses a two-phase Prepare → Execute workflow. Read-only executions include a safety check; mutation executions require explicit user confirmation after reviewing the prepared code snippet file.

What runtime dependencies are required?

Node.js and npm are required for installation. The remote server must have SSH access and a Rails environment available at the configured working directory.

What limits exist for code execution?

Only code saved via `prepare_code_snippet` and marked as `readOnly` or `mutate` can be executed. The server performs a safety check for read-only operations but not for mutations—the user must review code before mutating.

Comments

More Developer Tools MCP servers

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.