WeaveTab MCP V2

AIエージェントのためのゼロセットアップ・ローカルブラウザMCP

npm version License: MIT Socket Badge

WeaveTabは、AIエージェントがChrome DevTools Protocol (CDP) を使用してWebブラウザとシームレスに対話できるようにする、軽量なローカルModel Context Protocol (MCP) サーバーです。他のソリューションとは異なり、WeaveTabは完全に自律的かつゼロセットアップです。日常的なブラウジングと並行してサンドボックス化されたブラウザプロファイルを自動的に起動するため、ブラウザを閉じたり、デバッグポートの設定に悩まされたりする必要は二度とありません。

🌟 主な機能

ゼロセットアップ自律型ブラウザ: 隔離されたサンドボックスを介して、既存のブラウザと完全に並行して実行されます。手動のポート設定や、個人用ブラウザを閉じる必要はありません。
拡張機能不要: ネイティブCDPを介して直接接続します。
セマンティック・アクションマップ: weave_readは、解析済みで高度に圧縮されたDOMセマンティックマップを返し、トークン消費量を大幅に削減します。
スナイパーモード・アクション: weave_clickおよびweave_typeは、意図やラベルに基づいて、要素を自動的に特定し、ワンステップで操作します。
ローカル＆セキュア: クラウド依存関係はありません。レート制限とオプションのセーフモードが組み込まれています。
スクリーンショット対応: weave_screenshotを使用して現在のタブをキャプチャしたり、weave_peekを使用して特定の要素やキャンバスに対してターゲットを絞ったビジョン機能を利用したりできます。

🚀 クイックスタート (MCP統合)

WeaveTabを使用する最も簡単な方法はnpx経由です。MCPクライアントの設定（Cursor、OpenCode、Claude Desktopなど）に以下を追加してください。

Cursor / OpenCode

IDEのMCP設定に追加してください：

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

Claude Desktop

claude_desktop_config.jsonを編集してください：

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

🛠️ ツールアーセナル

WeaveTabは、AI向けに豊富な専門ツールを提供します：

weave_read: ページを読み取り、セマンティック・アクションマップを返します。
weave_click: ラベル、意図、またはIDで要素をクリックします。
weave_type: フォームに安全にテキストを入力します。
weave_navigate: 対象のURLに移動します。
weave_scroll: 上、下、先頭、または末尾にスクロールします。
weave_wait: 特定の状態（ナビゲーション、要素、DOMの安定性）を待機します。
weave_tabs: 開いているタブを一覧表示、または切り替えます。
weave_extract: 表示されているコンテンツをテキストまたはJSONとして抽出します。
weave_screenshot: 現在のビューのPNGをキャプチャします。
weave_peek: 特定の座標に対するターゲットを絞ったビジョン機能。
weave_key: 物理キーや修飾キーを押下します。
weave_find: ページ全体を抽出することなく、セマンティックに要素を検索します。

🛡️ セキュリティと設定

WeaveTabはシステムを尊重します。root/sudoとしての実行を積極的に拒否します。

初回実行時に、WeaveTabは~/.weavetab/config.jsonに設定ファイルを生成します：

{
  "safeMode": false,
  "allow": [],
  "rateLimitMs": 1000,
  "preferredBrowser": "google-chrome",
  "persistentProfile": false,
  "screenshot": true,
  "peek": true
}

安全機能

ストレージのハードブロック: 特定の環境でCookieやlocalStorageにアクセスするスクリプトを無効化します。
ルート検出: root権限で実行された場合は終了します。
ドメイン許可リスト: safeModeが有効な場合、エージェントが信頼できないサイトにアクセスするのを防ぎます。
監査ログ: AIによって実行されたすべてのアクションは、確認のために~/.weavetab/audit.logにローカルでクリーンに記録されます。

🤝 コントリビューション

コントリビューションを歓迎します！

git clone https://github.com/fy2ne/WeaveTab.git
cd WeaveTab
npm install
npm run build

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

WeaveTab-MCP