ブラウザ使用MCPサーバー
AI エージェントがbrowser-useを使用して Web ブラウザーを制御できるようにする MCP サーバー。
🔗 複数のMCPサーバーを管理していますか？エージェントブラウザで開発ワークフローを簡素化しましょう
前提条件
# Install prerequisites
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install mcp-proxy
uv tool update-shell
環境
.envファイルを作成します。
OPENAI_API_KEY=your-api-key
CHROME_PATH=optional/path/to/chrome
PATIENT=false # Set to true if API calls should wait for task completion
インストール
# Install dependencies
uv sync
uv pip install playwright
uv run playwright install --with-deps --no-shell chromium
使用法
SSEモード
# Run directly from source
uv run server --port 8000
stdioモード
# 1. Build and install globally
uv build
uv tool uninstall browser-use-mcp-server 2>/dev/null || true
uv tool install dist/browser_use_mcp_server-*.whl
# 2. Run with stdio transport
browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
クライアント構成
SSEモードクライアント構成
{
"mcpServers": {
"browser-use-mcp-server": {
"url": "http://localhost:8000/sse"
}
}
}
stdioモードクライアント構成
{
"mcpServers": {
"browser-server": {
"command": "browser-use-mcp-server",
"args": [
"run",
"server",
"--port",
"8000",
"--stdio",
"--proxy-port",
"9000"
],
"env": {
"OPENAI_API_KEY": "your-api-key"
}
}
}
}
設定場所
| クライアント | 構成パス |
|---|
| カーソル | ./.cursor/mcp.json |
| ウィンドサーフィン | ~/.codeium/windsurf/mcp_config.json |
| クロード（マック） | ~/Library/Application Support/Claude/claude_desktop_config.json |
| クロード（Windows） | %APPDATA%\Claude\claude_desktop_config.json |
特徴
- [x]ブラウザ自動化：AIエージェントによるブラウザ制御
- [x]デュアルトランスポート: SSEとstdioプロトコルの両方をサポート
- [x] VNCストリーミング:ブラウザの自動化をリアルタイムで見る
- [x]非同期タスク:ブラウザ操作を非同期に実行する
地域開発
パッケージをローカルで開発およびテストするには:
- 配布可能なホイールを構築する:
# From the project root directory
uv build
- グローバル ツールとしてインストールします。
uv tool uninstall browser-use-mcp-server 2>/dev/null || true
uv tool install dist/browser_use_mcp_server-*.whl
- 任意のディレクトリから実行します:
# Set your OpenAI API key for the current session
export OPENAI_API_KEY=your-api-key-here
# Or provide it inline for a one-time run
OPENAI_API_KEY=your-api-key-here browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
- 変更を加えた後、再構築して再インストールします。
uv build
uv tool uninstall browser-use-mcp-server
uv tool install dist/browser_use_mcp_server-*.whl
ドッカー
Docker を使用すると、サーバーを実行するための一貫性のある分離された環境が提供されます。
# Build the Docker image
docker build -t browser-use-mcp-server .
# Run the container with the default VNC password ("browser-use")
# --rm ensures the container is automatically removed when it stops
# -p 8000:8000 maps the server port
# -p 5900:5900 maps the VNC port
docker run --rm -p8000:8000 -p5900:5900 browser-use-mcp-server
# Run with a custom VNC password read from a file
# Create a file (e.g., vnc_password.txt) containing only your desired password
echo "your-secure-password" > vnc_password.txt
# Mount the password file as a secret inside the container
docker run --rm -p8000:8000 -p5900:5900 \
-v $(pwd)/vnc_password.txt:/run/secrets/vnc_password:ro \
browser-use-mcp-server
注: ボリュームマウント ( -v ) の:roフラグにより、コンテナ内のパスワード ファイルが読み取り専用になり、セキュリティが強化されます。
VNCビューア
# Browser-based viewer
git clone https://github.com/novnc/noVNC
cd noVNC
./utils/novnc_proxy --vnc localhost:5900
デフォルトのパスワード: browser-use (カスタム パスワード メソッドを使用して上書きされない限り)
例
AIに聞いてみてください:
open https://news.ycombinator.com and return the top ranked article
サポート
問題やお問い合わせについては、 cobrowser.xyz までお問い合わせください。
スターの歴史