MCP Server: SSH Rails Runner

一个 MCP 服务器，可以通过 SSH 安全地远程执行 Rails 控制台命令。此服务器为已部署的 Rails 环境中的只读操作和经过仔细管理的变更提供工具。

它与 Cursor 配合使用效果极佳。您可以使用 Cursor Composer 导入您的 Rails 模型文件作为上下文，然后使用 execute_read_only、dry_run_mutate 和 execute_mutate 工具来更改数据库。无需费力地通过复杂的管理用户界面来完成您的数据整理和分析。

示例

功能

• 通过 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