name: tidewave-integration description: Tidewave MCP 运行时工具用于 Phoenix 开发。在开发环境中运行时调试、测试代码或查询数据库时加载。 user-invocable: false

Tidewave MCP 集成

通过 MCP 为 Phoenix 应用提供运行时智能。在可用时，优先使用 Tidewave 工具而非 Bash。

铁律 — 切勿违反

仅限开发环境 — 切勿在生产环境中使用 Tidewave 工具。避免在具有生产数据副本的共享开发服务器上使用
优先使用 Tidewave 而非 Bash — mcp__tidewave__get_docs > web_fetch, execute_sql_query > psql
首先检查可用性 — 使用 /mcp 命令或检测 mcp__tidewave__ 工具
SQL 以读取为主 — 使用 execute_sql_query 进行 SELECT，小心突变操作
精确版本 — get_docs 返回 YOUR mix.lock 版本的文档，而非最新版本

快速参考

任务	Tidewave 工具	备用方案
获取文档	`mcp__tidewave__get_docs Module.func/3`	`web_fetch hexdocs.pm/...`
运行代码	`mcp__tidewave__project_eval`	`mix run -e "code"`
SQL 查询	`mcp__tidewave__execute_sql_query`	`psql $DATABASE_URL`
查找源码	`mcp__tidewave__get_source_location`	`grep -rn "defmodule"`
检查 DOM	`mcp__Tidewave-Web__browser_eval`	手动浏览器检查
列出模式	`mcp__tidewave__get_ecto_schemas`	读取 `lib/*/schemas/`
读取日志	`mcp__tidewave__get_logs level: :error`	`tail -f log/dev.log`

检测

# 检查端点
curl -s http://localhost:4000/tidewave/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'

或在 Claude Code 中使用 /mcp 查看连接的服务器。

基本模式

立即测试函数

# mcp__tidewave__project_eval
MyApp.Accounts.create_user(%{email: "test@example.com"})

验证迁移

-- mcp__tidewave__execute_sql_query
SELECT column_name, data_type FROM information_schema.columns
WHERE table_name = 'users';

调试 LiveView（使用浏览器中的 PID）

# mcp__tidewave__project_eval
pid = pid("0.1234.0")
:sys.get_state(pid) |> Map.get(:socket) |> Map.get(:assigns) |> Map.keys()

设置要求

# mix.exs
{:tidewave, "~> 0.1", only: :dev}

# endpoint.ex（在开发块中）
plug Tidewave

# config/dev.exs（用于 LiveView 源码映射）
config :phoenix_live_view,
  debug_heex_annotations: true,
  debug_attributes: true

主动运行时检查

不要仅仅被动使用 Tidewave。在工作流检查点自动查询运行时状态：

代码编辑后：get_logs level: :error（捕获运行时崩溃）
功能完成后：project_eval 冒烟测试（行为检查）
规划前：get_ecto_schemas + 路由评估（具体上下文）
调查时：在询问用户前自动捕获错误
LiveView UI 错误：browser_eval 在编辑组件前检查 DOM 状态

查看 references/proactive-patterns.md 获取完整集成点。

参考

有关详细模式，请参见：

references/proactive-patterns.md - 在工作流检查点的推送式运行时模式
references/tool-examples.md - 完整的工具使用示例
references/validation-checklist.md - 运行时验证模式