Tadasant MCP Server Ssh Rails Runner

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

MCP 服务器：SSH 铁路运行器是一款借助 SSH 实现远程 Rails 控制台命令安全执行的工具。它为部署在生产环境中的 Rails 环境提供支持，既能进行读取操作，也能实现受控修改。与 Cursor 搭配使用时，能让您更便捷地处理和分析数据，无需再依赖复杂的管理界面。

🚀 快速开始

MCP 服务器：SSH 铁路运行器可通过 SSH 远程执行 Rails 控制台命令，提供安全的只读操作、修改的干运行能力以及执行经过批准的修改等功能。以下是使用前的安装和配置步骤：

安装

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

✨ 主要特性

• 远程操作：通过 SSH 远程执行 Rails 控制台命令。
• 安全只读：支持安全的只读操作，保障数据安全。
• 干运行能力：具备修改的干运行能力（dry-run），可预先验证修改。
• 批准执行：能够执行经过批准的修改。
• 资源管理：支持管理代码片段资源。

💻 使用示例

基础用法

您可以使用 Cursor Composer 拉取您的 Rails 模型文件作为上下文，然后使用以下工具对数据库进行更改：

高级用法

以下是可用工具的详细说明：

run_read_only

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

dry_run_mutate

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

execute_mutate

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

🔧 技术细节

本服务器借助 SSH 协议实现远程 Rails 控制台命令的执行。通过对命令进行安全检查和控制，确保只读操作的安全性以及修改操作的可控性。同时，通过管理代码片段资源，方便用户对数据库进行操作。

⚠️ 安全注意事项

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

📄 许可证

本项目采用 MIT 许可证。