Tadasant MCP Server Ssh Rails Runner

🚀 MCP Server: SSH Rails Runner

An MCP server that securely executes remote Rails console commands via SSH. This server provides tools for Rails environments deployed in production, supporting read operations and controlled modifications.

It works even better when used with Cursor. You can use Cursor Composer to fetch your Rails model files as context, and then use tools like execute_read_only, dry_run_mutate, and execute_mutate to make changes to the database. No need to go through complex management interfaces for data processing and analysis.

📋 Examples

✨ Features

• Remotely execute Rails console commands via SSH
• Secure read-only operations
• Dry-run capability for modifications
• Execute approved modifications
• Manage code snippet resources

📦 Installation

npm install
npm run build

⚙️ Configuration

Set the following environment variables:

SSH_HOST=your.remote.host
SSH_USER=your_ssh_user
SSH_PRIVATE_KEY_PATH=your_SSH_PRIVATE_KEY_PATH
RAILS_WORKING_DIR=/path/to/rails/app

🤝 Usage with Claude Desktop

Add the following to your Claude Desktop configuration:

{
    "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": "your_SSH_PRIVATE_KEY_PATH",
                "RAILS_WORKING_DIR": "/path/to/rails/app/root"
            }
        }
    }
}

💻 Usage Examples

📖 run_read_only

Execute read-only Rails console operations. This tool analyzes requests, generates secure read-only commands, and returns results.

🛠️ dry_run_mutate

Plan and validate potential modifications. Create a code snippet resource containing the proposed changes without executing them.

✅ execute_mutate

Execute previously approved modification code snippets. Execution requires explicit user approval of a code snippet resource.

⚠️ Security Notes

⚠️ Important Note

• Only use on trusted SSH endpoints and temporarily provide access to the environment from your local machine.
• Review all modifications before execution.

📄 License

MIT