yad-agent-mcp

yad-agent-mcp

AI エージェントが、ユーザーが実際に使用しているログイン済みのブラウザーで、プライバシーを最優先するローカルのブラウザー自動化アシスタントであるYadを操作できるようにする MCP サーバーです。

これは薄いラッパーであり、ブラウザー自体は起動しません。stdio 経由で 127.0.0.1:3747 上にある Yad の既存のローカル HTTP API と通信します。そのため、MCP 互換クライアント（Claude Code、Cursor、Claude Desktop など）から Yad にページの移動、ページの読み取り、自然言語によるブラウザータスクの実行を依頼し、その結果を受け取れます。

ローカル専用として設計されています。 ホスト型やリモートの MCP サーバーではありません。Yad がインストールされ、実行中のマシン（Chrome／Edge／Brave の拡張機能とコンパニオンアプリが起動している環境）でのみ動作します。ローカルでの設定なしに、エージェントがインターネット経由で呼び出せるサーバーをお探しの場合、これは該当しません。そもそも、ユーザーの実際のログイン済みブラウザーセッションを操作するものが、そのような形で提供されるべきではありません。

要件

• Yad がインストールされ、実行中であること（Chrome、Edge、または Brave の拡張機能とローカルコンパニオンアプリ）
• Node.js 20 以降

インストール

npm install -g yad-agent-mcp

MCP クライアントの設定

Claude Code（.mcp.json または claude mcp add）：

{
  "mcpServers": {
    "yad-agent": {
      "command": "yad-agent-mcp"
    }
  }
}

Yad のコンパニオンアプリがデフォルト以外のポートで実行されている場合は、YAD_COMPANION_URL を設定してください（デフォルトは http://127.0.0.1:3747 です）。

ツール

ツール	機能
yad_status	Yad のコンパニオンアプリが実行中で、ブラウザーに接続されているかを確認します。最初に呼び出してください。
yad_navigate	Yad が操作するブラウザーのタブで URL を開きます。
yad_capture	現在のページの URL、タイトル、表示テキスト、リンクを読み取ります。
yad_run_goal	自然言語でタスク（「最初の商品の価格を調べる」「ログインボタンをクリックする」など）を Yad に指示し、結果を待ちます。
yad_last_result	直近の yad_run_goal 呼び出しの結果を再度読み取ります。

エージェントからどのような指示があっても、ユーザー自身の確認なしに Yad がチェックアウト、支払い、注文を行うことはできません。このラッパーがその制限を追加したり取り除いたりすることはありません。この制限は Yad 自体によって適用されます。

ソース

al-yad モノレポの一部です。Issue や PR はそちらで歓迎します。

ライセンス

MIT