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

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

• 실행 중인 앱 맥락에서 코드 실행 (예: 에이전트의 IEx 세션)
• 앱의 실시간 로그 읽기
• 개발 데이터베이스 조회
• 모듈과 함수의 소스 위치 얻기
• 프로젝트가 의존하는 정확한 HEX 패키지 버전에 고정된 문서를 읽어보세요

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

아래 설치 지침을 따라 독립형 MCP 서버로 사용하거나 Tidewave 제품과 통합할 수 있습니다.

설치

1. Tidewave hex 패키지를 앱에 추가하세요

옵션 1: 수동

tidewave 패키지를 mix.exs에 추가:

그런 다음 피닉스 신청을 위해 lib/my_app_web/endpoint.ex로 가서 if code_reloading? do 블록 바로 위에 다음을 추가하세요:

[! 팁] Tidewave는 Phoenix LiveView v1.1 이상에서 가장 잘 작동합니다. 업데이트하면, config/dev.exs에서 다음 옵션을 활성화하세요:

Tidewave Phoenix

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

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

• execute code in the context of the running app (like an IEx session for agents)
• read the app’s live logs
• query your development database
• get source locations of modules and functions
• read documentation pinned to the exact hex package versions your project depends on

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

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

Installation

1. Add the Tidewave hex package to your app

Option 1: Manually

Add the tidewave package to your mix.exs:

def deps do
  [
    {:tidewave, "~> 0.9", only: :dev},
    {:phoenix, ...},
  ]
end

Then, for Phoenix applications, go to your lib/my_app_web/endpoint.ex and right above the if code_reloading? do block, add:

+  if Mix.env() == :dev do
+    plug Tidewave
+  end

   if code_reloading? do

[!TIP] Tidewave works best with Phoenix LiveView v1.1 or later. Once you update it, make sure to enable the following options in your config/dev.exs:

config :phoenix_live_view,
  debug_heex_annotations: true,
  debug_attributes: true

Those are enabled by default for Phoenix v1.8+ apps.

Option 2: Using Igniter

Alternatively, you can use igniter to automatically install Tidewave MCP into an existing Phoenix application:

# install igniter_new if you haven't already
mix archive.install hex igniter_new

# install tidewave
mix igniter.install tidewave

Umbrella projects

For umbrella projects, you can follow the manual steps above in the application that defines your Phoenix endpoint (typically apps/your_app_web).

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:4000/tidewave/mcp.

We also have specific instructions for:

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

[!TIP] If you are using worktrees, you are likely running your web server on different ports, and therefore there isn’t a single host and port combo you can use.