Tidewave Railsは、コーディングエージェントを使ってRuby on Railsアプリを開発するためのランタイムレベルのツールを提供するMCPサーバーです。

エージェントはこのMCPサーバーを使って、開発中のRailsアプリと通信できるようになります:

• 実行中のアプリの文脈でコードを実行(エージェント向けのRailsコンソールなど)
• アプリのライブログを読む
• 開発データベースを検索する
• クラスやメソッドのソース位置を取得する
• アプリが依存する正確な宝石バージョンに固定されたドキュメントを読むこと

このMCPサーバーは、RailsやPhoenix向けのエージェント開発環境であるTidewaveのオープンソースコンポーネントです。

このプロジェクトは、以下の指示に従うことで、スタンドアロンのMCPサーバーとしてまたはTidewave製品と統合することができます。

設置

1.Tidewaveジェムをアプリに追加しましょう

Tidewave Railsをアプリに追加するには、以下を実行します:

または、Gemファイルの開発グループに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.