Tidewave Rails는 코딩 에이전트를 사용하여 Ruby on Rails 앱을 개발할 수 있는 런타임 수준의 도구를 제공하는 MCP 서버입니다.

에이전트는 이 MCP 서버를 사용해 개발 중인 Rails 앱과 통신할 수 있습니다:

• 실행 중인 앱의 맥락에서 코드를 실행(예: 에이전트용 Rails 콘솔)
• 앱의 실시간 로그 읽기
• 개발 데이터베이스 조회
• 클래스와 메서드의 소스 위치 얻기
• 앱이 의존하는 정확한 보석 버전에 고정된 문서를 읽어보세요

이 MCP 서버는 Rails와 Phoenix의 에이전트 개발 환경인 Tidewave의 오픈소스 구성 요소입니다.

아래 지침을 따라 독립형 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.