MCP Server: Local Rails Runner

Overview

基本能力

产品定位

MCP Server: Local Rails Runner 是一个用于本地执行Rails控制台命令的工具，特别适合开发者在本地Rails环境中进行数据操作和分析。

核心功能

本地Rails控制台执行
安全的只读操作
变更操作的干运行能力
执行已批准的变更操作
代码片段资源管理

适用场景

在本地Rails环境中进行数据查询和分析
在开发环境中测试数据库变更
通过代码片段管理复杂的数据库操作

工具列表

execute_read_only：执行只读的Rails控制台操作，分析请求并返回安全的结果。
dry_run_mutate：计划和验证潜在的变更操作，创建包含提议变更的代码片段资源但不执行。
execute_mutate：执行之前已批准的变更代码片段，需要用户明确批准。

常见问题解答

确保Rails环境正确配置
在执行前审查所有变更操作
对生产数据库要特别小心
确保Rails应用程序的依赖项已正确安装

使用教程

使用依赖

本地安装Ruby和Rails
安装Bundler
访问Rails应用程序目录
安装Node.js和npm

安装教程

npm install
npm run build

配置

设置以下环境变量：

RAILS_WORKING_DIR=/path/to/rails/app

可选设置：

PROJECT_NAME_AS_CONTEXT=your_project_name

调试方式

在Claude Desktop配置中添加：

{
    "mcpServers": {
        "local-rails-runner": {
            "command": "npm",
            "args": [
                "-C",
                "/Users/hoshino/ghq/github.com/hoshinotsuyoshi/mcp-server-local-rails-runner",
                "run",
                "start"
            ],
            "env": {
                "RAILS_WORKING_DIR": "/path/to/rails/app/root"
            }
        }
    }
}

许可证

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