Tadasant MCP Server Ssh Rails Runner

🚀 MCP 服务器：SSH 铁路运行器

MCP 服务器：SSH 铁路运行器是一个借助 SSH 实现远程 Rails 控制台命令安全执行的工具。它为生产环境中的 Rails 环境提供支持，既允许读取操作，也能进行受控修改，极大提升了数据处理和分析的便捷性。与 Cursor 配合使用时，可借助 Cursor Composer 拉取 Rails 模型文件作为上下文，使用特定工具对数据库进行更改，无需复杂的管理界面。

🚀 快速开始

您可以参考下面的示例图，直观了解该工具的使用效果。

✨ 主要特性

• 通过 SSH 远程执行 Rails 控制台命令
• 安全的只读操作
• 修改的干运行能力（dry-run）
• 执行经过批准的修改
• 管理代码片段资源

📦 安装指南

在您的环境中执行以下命令进行安装：

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

可用工具

run_read_only

执行只读的 Rails 控制台操作。该工具会分析请求，生成安全的只读命令并返回结果。

dry_run_mutate

计划和验证潜在修改。创建一个代码片段资源，其中包含拟议的更改，但不会执行它们。

execute_mutate

执行之前经过批准的修改代码片段。需要用户明确批准某个代码片段资源后才能执行。

安全注意事项

⚠️ 重要提示

• 只在受信任的 SSH 端点上使用，且从您的本地机器暂时提供对该环境的访问权限。
• 在执行前审核所有修改。

📄 许可证

本项目采用 MIT 许可证。