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のブロックのすぐ上に、以下を追加してください:

[!ヒント] 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.