🚀 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 许可证。