MCP Server: SSH Rails Runner

Overview

基本能力

产品定位

MCP Server: SSH Rails Runner 是一个专为Rails开发者设计的工具，用于通过SSH安全地远程执行Rails控制台命令，支持只读操作和受控的数据库变更。

核心功能

通过SSH远程执行Rails控制台命令
安全的只读操作
变更前的模拟运行（dry-run）能力
执行已批准的数据库变更
代码片段资源管理

适用场景

在部署的Rails环境中进行数据分析和操作
避免使用复杂的管理界面进行数据操作
需要安全地进行数据库变更的场景

工具列表

run_read_only：执行只读的Rails控制台操作，分析请求并返回安全的结果。
dry_run_mutate：计划和验证潜在的数据库变更，创建变更代码片段但不执行。
execute_mutate：执行之前已批准的变更代码片段，需要用户明确批准。

常见问题解答

安全性：仅建议在信任的SSH端点上使用，且仅临时提供对远程环境的访问权限。
变更审查：在执行前需审查所有变更。

使用教程

使用依赖

确保已安装Node.js和npm。

安装教程

npm install
npm run build

配置环境变量

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

调试方式

将服务添加到Claude Desktop配置中：

{
    "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"
            }
        }
    }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。