MCP

🚀 Browser MCP Server

このModel Context Protocol (MCP)サーバーは、Playwrightを用いてAnchor Browserのリモートブラウザサービスを使い、ブラウザ自動化機能を提供します。このサーバーにより、LLMはAnchorのクラウドベースのブラウザを介して、組み込みのプロキシ、ステルス機能、高度な機能を備えたウェブページとやり取りすることができます。

✨ 主な機能

• リモートブラウザ実行：ローカルブラウザではなく、Anchor Browserのクラウドインフラストラクチャを使用
• 組み込みプロキシ：自動住宅用プロキシのローテーションと地理的ターゲティング
• ステルスと反検出：高度なブラウザフィンガープリントと反ボット検出
• 高速かつ軽量：Playwrightのアクセシビリティツリーを使用し、ピクセルベースの入力ではない
• LLMに友好的：ビジョンモデルは必要なく、純粋に構造化データで動作
• 決定的なツール適用：スクリーンショットベースのアプローチで一般的な曖昧さを回避

📦 インストール

• Node.js 18以上
• Anchor Browser APIキー (ここで取得)
• VS Code、Cursor、Windsurf、Claude Desktop、Gooseまたはその他のMCPクライアント

🚀 クイックスタート

1. リポジトリのクローンとビルド

これはカスタムのBrowser MCPサーバーなので、ローカルでビルドする必要があります。

# リポジトリをクローン
git clone https://github.com/anchorbrowser/anchor-mcp.git
cd anchor-mcp

# 依存関係のインストールとビルド
npm install
npm run build

2. Anchor APIキーの取得

1. anchorbrowser.ioでサインアップ
2. ダッシュボードからAPIキーを取得
3. APIキー（sk-で始まる）をコピー

3. MCPクライアントの設定

Cursor

~/.cursor/mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

VS Code

MCP設定に以下を追加します。

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

4. MCPクライアントの再起動

設定を更新した後、MCPクライアント（Cursor、VS Codeなど）を再起動して、新しいサーバーを読み込みます。

📚 ドキュメント

設定オプション

Browser MCPサーバーは、必須の設定オプションのみをサポートしています。

node cli.js --help

利用可能なオプション:

• --host <host> - サーバーをバインドするホスト（デフォルト: localhost、すべてのインターフェースにバインドするには0.0.0.0を使用）
• --port <port> - HTTPトランスポートでリッスンするポート（Docker/サーバーモード）

オプションを使用した例:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js",
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

HTTPサーバーモード（Docker）:

Dockerまたはヘッドレスサーバー環境の場合:

# HTTPサーバーとして実行
ANCHOR_API_KEY="sk-your-key" node cli.js --port 8931 --host 0.0.0.0

次に、MCPクライアントを構成して、HTTPエンドポイントを使用するようにします。

{
  "mcpServers": {
    "anchor-browser": {
      "url": "http://localhost:8931/mcp"
    }
  }
}

なぜオプションが少ないのか？

Anchor Browserがすべての複雑なブラウザ管理をリモートで処理するため、ほとんどの従来のブラウザオプションは不要です。

• ブラウザ選択なし - Anchorは最適化されたリモートブラウザを使用
• プロキシ設定なし - Anchorが組み込みのプロキシローテーションを提供
• ブラウザプロファイル管理なし - Anchorのインフラストラクチャによって処理
• ネットワークフィルタリングなし - 高度な制御にはAnchorのダッシュボードを使用
• ビューポート/デバイスオプションなし - Anchor Browser APIを介してこれらを構成

これにより、MCPサーバーはシンプルに保たれ、重要なことに集中できます。つまり、Anchorのリモートブラウザサービスへの接続です。

仕組み

1. ブラウザセッションの作成：ブラウザツールを使用すると、MCPサーバーはAnchorのAPIを呼び出して、リモートブラウザセッションを作成
2. リモート接続：Chrome DevTools Protocol (CDP)を使用して、WebSocketを介してリモートブラウザに接続
3. ツール実行：すべてのブラウザ自動化はAnchorのクラウドインフラストラクチャで行われる
4. プロキシとステルス：自動住宅用プロキシのローテーションと高度な反検出機能
5. セッション管理：各セッションは分離されており、Anchorのダッシュボードを介してライブで表示できる

ローカルブラウザに比べた利点

🌐 グローバルプロキシネットワーク

• 自動住宅用プロキシのローテーション
• 異なる地域の地理的ターゲティング
• プロキシ設定不要

🛡️ 高度なステルス

• ブラウザフィンガープリント保護
• 反ボット検出回避
• 実際のブラウザ環境

☁️ クラウドインフラストラクチャ

• ローカルブラウザの依存関係なし
• 一貫したブラウザバージョン
• スケーラブルな実行

📊 監視とデバッグ

• ブラウザセッションのライブビュー
• セッションの録画とトレース
• ネットワークリクエストのロギング

利用可能なツール

Browser MCPサーバーは、すべての標準ブラウザ自動化ツールを提供します。

コア自動化

• anchor_navigate - URLに移動
• anchor_click - 要素をクリック
• browser_type - 入力欄にテキストを入力
• browser_snapshot - ページのアクセシビリティツリーを取得
• browser_take_screenshot - スクリーンショットを撮る
• browser_evaluate - JavaScriptを実行
• browser_wait_for - 条件を待つ

タブ管理

• browser_tab_new - 新しいタブを開く
• browser_tab_list - 開いているタブをリストする
• browser_tab_select - タブを切り替える
• browser_tab_close - タブを閉じる

高度な機能

• browser_file_upload - ファイルをアップロードする
• browser_handle_dialog - アラート/確認ダイアログを処理する
• browser_network_requests - ネットワークトラフィックを表示する
• browser_pdf_save - PDFを生成する（--caps=pdfを使用）

トラブルシューティング

無効なAPIキー

Error: Missing ANCHOR_API_KEY environment variable

解決策：APIキーがMCP設定に正しく設定されていることを確認してください。

ビルドエラー

npm run build

解決策：Node.js 18以上がインストールされていることを確認し、最初にnpm installを実行してください。

接続問題

MCPログでAnchor APIの応答とWebSocketの接続状態を確認してください。

セッション制限

各Anchor APIキーにはセッション制限があります。anchorbrowser.ioのダッシュボードで使用状況を確認してください。

開発

Browser MCPサーバーを変更または拡張するには：

# src/のTypeScriptファイルを変更する
# その後、再ビルドする
npm run build

# 変更をテストする
node cli.js --help

サーバーは自動的にAnchorのリモートブラウザをすべての操作に使用し、高度なプロキシとステルス機能を備えたクラウドベースのブラウザ自動化の利点を提供します。

📄 ライセンス

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

サポート

• Anchor Browser: anchorbrowser.io
• ドキュメント: Anchor Browser Docs
• MCPプロトコル: Model Context Protocol