Agent Browser Server

Vercel上でホストされたブラウザ自動化MCPサーバーです。Cursor AgentsやローカルCursorからブラウザ操作を実行できます。

機能

• browser_open - URLを開いて新しいセッションを開始（Basic認証対応）
• browser_snapshot - ページのアクセシビリティスナップショットを取得
• browser_click - 要素をクリック
• browser_fill - フォームフィールドに値を入力
• browser_type - テキストをタイプ（人間らしい入力）
• browser_get_text - 要素からテキストを取得
• browser_screenshot - スクリーンショットを撮影
• browser_wait - 要素が表示されるまで待機
• browser_press_key - キーを押す
• browser_close - セッションを終了

セットアップ

1. 環境変数

Vercelダッシュボードで以下の環境変数を設定:

変数名	説明	必須
MCP_AUTH_TOKEN	MCP認証トークン	Yes
BROWSERLESS_TOKEN	Browserless.io APIトークン	Yes
KV_REST_API_URL	Vercel KV URL	Yes
KV_REST_API_TOKEN	Vercel KV Token	Yes

2. Browserless.io

Browserless.ioでアカウントを作成し、APIトークンを取得してください。

3. Vercel KV

Vercelダッシュボードでプロジェクトに「KV」ストレージを追加してください。

使用例

Basic認証が必要なサイトを開く

Basic認証で保護されたサイトにアクセスする場合は、basic_authパラメータを指定します:

```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "browser_open", "arguments": { "url": "https://protected-site.example.com", "basic_auth": { "username": "your-username", "password": "your-password" } } } } ```

認証情報はセッションに保存されるため、同じセッションIDを使う後続の操作でも認証が維持されます。

Cursor Agents での使用方法

リポジトリの .cursor/mcp.json に以下を追加:

```json { "mcpServers": { "agent-browser": { "url": "https://agent-browser-mcp-server.vercel.app/mcp", "headers": { "Authorization": "Bearer ${env:AGENT_BROWSER_MCP_AUTH_TOKEN}" } } } } ```

そして、Cursor Dashboard の Cloud Agents → Secrets で AGENT_BROWSER_MCP_AUTH_TOKEN を登録してください。

セッション管理

セッションには以下が含まれます:

• Cookie
• localStorage
• 現在のURL
• Basic認証情報

セッションは15分間有効です。

ライセンス

MIT