MCP Server: SSH Rails Runner

Overview

基本能力

产品定位

MCP Server: SSH Rails Runner 是一个支持通过SSH安全远程执行Rails控制台命令的MCP服务器。它提供了只读操作和谨慎管理的数据库变更功能，适用于在部署的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 run_read_only

许可证

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