Tidewave Phoenix で、開発中のアプリケーションとAIチャットが一体化 #Elixir – Qiita

まずは MCP サーバーの動作を確認するための Inspector から動作確認してみましょう

以下のコマンドで Inspector を起動します

npx @modelcontextprotocol/inspector

http://localhost:6274/ にアクセスすると、 Inspector の画面が開きます

以下の値を設定し、 “Connect” ボタンをクリックしましょう

画面中央に表示される “List Tools” をクックすると、 Tidewave で利用できるツールが取得できます

表示されたツールの内容を和訳してみました

• get_logs
  すべてのログ出力を返しますが、他のツールの呼び出しによって生成されたログは除外されます。このツールは、リクエストログや記録された可能性のあるエラーを確認するために使用します
• get_source_location
  指定されたモジュール（または関数）のソースの場所を返します。これは、現在のプロジェクト内のモジュールや依存関係のモジュールには対応していますが、Elixir本体に含まれるモジュールには対応していません。このツールは、対象となる特定のモジュール（およびオプションで関数）がわかっている場合にのみ使用できます。そのような場合は、ファイルシステム全体を grep するよりも、このツールを使用する方が推奨されます
• project_eval
  Elixirコードをプロジェクトのコンテキスト内で評価します。現在のElixirバージョンは 1.18.3 です。このツールは、関数の動作をテストしたり、何かをデバッグしたりするなど、Elixirコードを評価する必要があるすべての場面で使用します。標準出力に書き込まれた内容も返されます
  注意： Elixirコードの評価には常にこのツールを使用し、シェルツールを使ってはいけません
  また、このツールでは IEx のヘルパーも使用可能なため、モジュールや関数のドキュメントを確認するには、以下のように h ヘルパーを使ってください：h Enum.map/2
• execute_sql_query
  指定されたSQLクエリを、デフォルトまたは指定されたEctoリポジトリに対して実行します。結果はElixirのデータ構造として返されます
  重要なポイント:
  • 出力は一度に 最大50行 に制限されています。さらに多くの行を見る必要がある場合は、クエリに LIMIT と OFFSET を使用して複数回呼び出してください。
  • 必要なカラムが限られている場合は、SELECT 句にそのカラムだけを記述することで効率を向上させられます
  • ユーザーデータの取得、エントリの操作、アプリケーションデータドメインの調査などに使用できます
  • 使用するデータベースに適したSQLコマンドを正しく使うようにしてください
    repo パラメータの説明には、利用可能なリポジトリとそのアダプタの一覧が含まれています
• get_ecto_schemas
  現在のプロジェクトに存在するすべての Ectoスキーマモジュール とその ファイルパス を一覧表示します。このプロジェクトがEctoを使用している場合に、利用可能なスキーマの概要を把握するためにこのツールを使用します
  特定のスキーマを探す必要がある場合、ファイルシステム全体を grep するよりも、このツールを使う方が推奨されます
• get_process_info
  プロセスに関する詳細な情報を返します。PID（プロセスID） か 名前 のどちらかを指定する必要があります
  このツールは、特定の LiveView や 名前付きGenServer に関する問題をデバッグする際などに、そのプロセスの状態を調べるために使用します
• trace_process
  プロセスに対して送受信されるメッセージを、指定されたメッセージ数に達するまでトレースします。これは非常に特化されたデバッグ用ツールで、たとえば GenServer や LiveView 内で「何が起きているかわからない」状況を解明するために使用されます
  使用時の注意点：
  • ツール実行時には、ユーザーに「プロセスのトレースを開始する」と伝え、問題が起きている操作をツール実行後に再現してもらうよう依頼してください
  • 初期のメッセージ数は 10程度の低い数 に設定し、必要に応じて増やします
  • トレースは、指定されたメッセージ数に到達するか、タイムアウトになるまで実行をブロックします
• list_liveview_pages
  現在接続されている LiveView の一覧を返します。このツールは、プロジェクトが Phoenix LiveView を使用していて、ユーザーが「現在のページ」や「現在のLiveView」で何か問題が発生していると話している場合に使用します
• package_docs_search
  プロジェクトの依存関係や指定されたパッケージの Hexドキュメント を検索します
  ただし、特定のモジュールや関数のドキュメントを調べたい場合は、まず project_eval ツールを使って h ヘルパーを実行する方が推奨されます。これは、ローカルでのドキュメント取得に適しており、より正確かつ迅速です
• package_search
  Hex上で 新しいパッケージを検索するためのツールです。プロジェクトに追加すべきパッケージを探す場合に使用します
  使用の前に：
  既存の依存関係を把握するために、まず project_eval ツールを使って以下を実行してください：Mix.Project.deps_apps()
  これにより、すでに使用されているパッケージの一覧が確認できます
  検索結果は デフォルトで人気順（ダウンロード数順） に並べられます

いくつか試してみましょう

list_liveview_pages

[
  %{
    memory: 19008,
    message_queue_len: 0,
    module: MyTidewaveAppWeb.UserLive.Index,
    pid: "#PID",
    view: MyTidewaveAppWeb.UserLive.Index,
    live_action: :index
  }
]

[
  %{
    memory: 147496,
    message_queue_len: 0,
    module: MyTidewaveAppWeb.UserLive.Index,
    pid: "#PID",
    view: MyTidewaveAppWeb.UserLive.Index,
    live_action: :new
  }
]

{
    "servers": {
        "tidewave": {
            "type": "sse",
            "url": "http://localhost:4000/tidewave/mcp"
        }
    }
}