用途：通过 MCP 为运行中的 Phoenix 应用提供运行时智能，用于调试、冒烟测试、实时状态检查、SQL 查询和 hex 文档查询。资料建议在可用时优先使用 Tidewave 工具而非 Bash。
主要能力：get_docs 按 mix.lock 精确版本返回文档；project_eval 在运行中执行代码；execute_sql_query 执行 SQL；get_source_location 定位源码；browser_eval 检查 DOM；get_ecto_schemas 列出 schema；get_logs 读取日志。
使用方式：在 mix.exs 添加 {:tidewave, "~> 0.6", only: :dev}，在 endpoint.ex 的 dev 块加入 plug Tidewave，并在 config/dev.exs 配置 Phoenix LiveView 的 debug_heex_annotations 与 debug_attributes。依赖与 plug 只暴露可流式 HTTP 服务，不会自动注册到 MCP 客户端，需另行配置 http://localhost:<port>/tidewave/mcp 并确认工具可用。可用 curl 向该端点发送 ping 检测，或在 Claude Code 用 /mcp 查看已连接服务器。
适用场景：在运行中的 Phoenix 应用内验证函数、核对迁移、调试 LiveView、执行只读 SQL、查看错误日志，以及在功能完成后做简短 QA 走查。
限制：仅限开发环境，禁止用于生产或含生产数据副本的共享开发服务器；SQL 以读为主，变更需谨慎；运行时输出无上限，应加 LIMIT 20、Enum.take(20) 或 inspect 限制；多 worktree 时需先确认端点属于当前检出；写 SQL 前先用 get_ecto_schemas 或 information_schema.columns 确认列名；browser_eval 不可用时改用服务端检查。资料未提供收费、价格与平台信息。