Tidewave Rails 是一款 MCP 服务器，提供运行时级工具，用于使用编码代理开发 Ruby on Rails 应用。

你的代理将能够使用该MCP服务器与你正在开发的Rails应用通信：

• 在运行中的应用上下文中执行代码（如代理的 Rails 控制台）
• 阅读应用的实时日志
• 查询您的开发数据库
• 获取类和方法的源位置
• 阅读钉顶到你应用依赖的精确宝石版本的文档

该MCP服务器是Tidewave的开源组件，Tidewave是Rails和Phoenix的代理开发环境。

您可以按照以下说明将该项目作为独立的MCP服务器使用，或与Tidewave产品集成。

安装

1.把潮汐宝石添加到你的应用里

您可以通过以下操作将Tidewave Rails添加到您的应用中：

或者手动将tidewave宝石添加到宝石文件中的开发组：

2.把Tidewave MCP添加到你的代理/编辑中

将Tidewave MCP服务器添加到编辑器或MCP客户端配置中，类型为“http”（可流式），指向你的网页应用运行的/tidewave/mcp路径和端口。

Tidewave Rails

Tidewave Rails is an MCP server that provides runtime-level tools for developing Ruby on Rails apps using coding agents.

Your agent will be able to use this MCP server to talk to your running Rails app in development to:

• execute code in the context of the running app (like a Rails console for agents)
• read the app’s live logs
• query your development database
• get source locations of classes and methods
• read documentation pinned to the exact gem versions your app depends on

This MCP server is an open-source component of Tidewave, the agentic development environment for Rails and Phoenix.

You can use this project as a standalone MCP server or integrated with the Tidewave product by following the instructions below.

Installation

1. Add the Tidewave gem to your app

You can add Tidewave Rails to your app by running:

bundle add tidewave --group development

or by manually adding the tidewave gem to the development group in your Gemfile:

gem "tidewave", group: :development

2. Add the Tidewave MCP to your agent/editor

Add the Tidewave MCP server to your editor or MCP client configuration as the type “http” (streamable), pointing to the /tidewave/mcp path and port your web application is running at. For example, http://localhost:3000/tidewave/mcp.

We also have specific instructions for:

• Claude Code
• Codex
• Cursor
• Neovim
• OpenCode
• VS Code
• Others

Usage

As with any other MCP server, your agent will call the tools exposed by the Tidewave MCP whenever it sees fit. But you can also prompt it to call them explicitly.

Available MCP tools

project_eval

Evaluates Ruby code in the context of your running application, with access to its runtime, loaded dependencies, and in-memory data, returning the result plus anything printed to standard output. It’s like a Rails console for the agent.

Your agent can use it when it would rather run code than assume behavior, grounding its next step in what the running app actually does. For example, calling a method to see what comes back or reproducing a failing code path against live app state to debug it.

execute_sql_query

Runs a SQL query against your app’s development database and returns the rows to the agent.