# Agent Browser MCP 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](https://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
