MCP Server: SSH Rails Runner

基本能力

产品定位

该 MCP 服务器旨在通过 SSH 安全地远程执行 Rails 控制台命令，提供只读操作和谨慎管理的变更功能。

核心功能

• 通过 SSH 远程执行 Rails 控制台命令
• 安全的只读操作
• 变更的干运行能力
• 执行已批准的变更
• 代码片段的资源管理

适用场景

• 在部署的 Rails 环境中进行数据操作和分析
• 避免使用复杂的管理界面
• 需要安全地远程执行 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 一起使用

添加到 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"
            }
        }
    }
}

调试方式

安装完成后，可以通过运行以下命令来测试服务器是否正常工作：

npx mcp-server-ssh-rails-runner

确保所有环境变量已正确设置，并且 SSH 连接可以正常建立。

许可证

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