MCP Webブラウザサーバー

Playwright を搭載した Model Context Protocol (MCP) 用の高度な Web ブラウジングサーバーで、柔軟で安全な API を通じてヘッドレスブラウザーインタラクションが可能になります。

🌐 特徴

ヘッドレスWebブラウジング：SSL証明書の検証をバイパスして任意のWebサイトに移動する
フルページコンテンツ抽出: 動的に読み込まれたJavaScriptを含む完全なHTMLコンテンツを取得します。
マルチタブサポート: 複数のブラウザタブを作成、管理、切り替え
高度なWebインタラクションツール:
- テキストコンテンツを抽出する
- ページ要素をクリック
- フォームフィールドにテキストを入力する
- スクリーンショットをキャプチャする
- フィルタリング機能を使用してページリンクを抽出します
- ページを任意の方向にスクロールします
- ページでJavaScriptを実行する
- ページを更新
- ナビゲーションが完了するまでお待ちください
リソース管理: 非アクティブ後の未使用リソースの自動クリーンアップ
拡張ページ情報: 現在のページに関する詳細なメタデータを取得します

🚀 クイックスタート

前提条件

Python 3.10以上
MCP SDK
劇作家

インストール

# Install MCP and Playwright
pip install mcp playwright

# Install browser dependencies
playwright install

Claudeデスクトップの設定

claude_desktop_config.jsonに追加します:

{
  "mcpServers": {
    "web-browser": {
      "command": "python",
      "args": [
        "/path/to/your/server.py"
      ]
    }
  }
}

💡 使用例

基本的なウェブナビゲーション

# Browse to a website
page_content = browse_to("https://example.com")

# Extract page text
text_content = extract_text_content()

# Extract text from a specific element
title_text = extract_text_content("h1.title")

ウェブインタラクション

# Navigate to a page
browse_to("https://example.com/login")

# Input text into a form
input_text("#username", "your_username")
input_text("#password", "your_password")

# Click a login button
click_element("#login-button")

スクリーンショットキャプチャ

# Capture full page screenshot
full_page_screenshot = get_page_screenshots(full_page=True)

# Capture specific element screenshot
element_screenshot = get_page_screenshots(selector="#main-content")

リンク抽出

# Get all links on the page
page_links = get_page_links()

# Get links matching a pattern
filtered_links = get_page_links(filter_pattern="contact")

マルチタブブラウジング

# Create a new tab
tab_id = create_new_tab("https://example.com")

# Create another tab
another_tab_id = create_new_tab("https://example.org")

# List all open tabs
tabs = list_tabs()

# Switch between tabs
switch_tab(tab_id)

# Close a tab
close_tab(another_tab_id)

高度なインタラクション

# Scroll the page
scroll_page(direction="down", amount="page")

# Execute JavaScript on the page
result = execute_javascript("return document.title")

# Get detailed page information
page_info = get_page_info()

# Refresh the current page
refresh_page()

# Wait for navigation to complete
wait_for_navigation(timeout_ms=5000)

🛡️ セキュリティ機能

SSL証明書検証バイパス
安全なブラウザコンテキスト管理
カスタムユーザーエージェント構成
エラー処理と包括的なログ記録
設定可能なタイムアウト設定
CSPバイパス制御
クッキー盗難防止

🔧 トラブルシューティング

よくある問題

SSL証明書エラー: 自動的にバイパスされます
ページの読み込みが遅い: browse_to()メソッドのタイムアウトを調整する
要素が見つかりません: セレクターを慎重に確認してください
ブラウザのリソース使用状況: 非アクティブ期間後の自動クリーンアップ

ログ記録

すべての重要なイベントは詳細な情報とともに記録され、デバッグが容易になります。

📋 ツールパラメータ

`browse_to(url: str, context: Optional[Any] = None)`

url : 移動するウェブサイト
context : オプションのコンテキストオブジェクト（現在は未使用）

`extract_text_content(selector: Optional[str] = None, context: Optional[Any] = None)`

selector : 特定のコンテンツを抽出するためのオプションのCSSセレクター
context : オプションのコンテキストオブジェクト（現在は未使用）

`click_element(selector: str, context: Optional[Any] = None)`

selector : クリックする要素のCSSセレクター
context : オプションのコンテキストオブジェクト（現在は未使用）

`get_page_screenshots(full_page: bool = False, selector: Optional[str] = None, context: Optional[Any] = None)`

full_page : ページ全体のスクリーンショットをキャプチャする
selector : スクリーンショットのオプション要素
context : オプションのコンテキストオブジェクト（現在は未使用）

`get_page_links(filter_pattern: Optional[str] = None, context: Optional[Any] = None)`

filter_pattern : リンクをフィルタリングするためのオプションのテキストパターン
context : オプションのコンテキストオブジェクト（現在は未使用）

`input_text(selector: str, text: str, context: Optional[Any] = None)`

selector : 入力要素のCSSセレクター
text : 入力するテキスト
context : オプションのコンテキストオブジェクト（現在は未使用）

`create_new_tab(url: Optional[str] = None, context: Optional[Any] = None)`

url : 新しいタブで移動するオプションのURL
context : オプションのコンテキストオブジェクト（現在は未使用）

`switch_tab(tab_id: str, context: Optional[Any] = None)`

tab_id : 切り替えるタブのID
context : オプションのコンテキストオブジェクト（現在は未使用）

`list_tabs(context: Optional[Any] = None)`

context : オプションのコンテキストオブジェクト（現在は未使用）

`close_tab(tab_id: Optional[str] = None, context: Optional[Any] = None)`

tab_id : 閉じるタブのオプションID（デフォルトは現在のタブ）
context : オプションのコンテキストオブジェクト（現在は未使用）

`refresh_page(context: Optional[Any] = None)`

context : オプションのコンテキストオブジェクト（現在は未使用）

`get_page_info(context: Optional[Any] = None)`

context : オプションのコンテキストオブジェクト（現在は未使用）

`scroll_page(direction: str = "down", amount: str = "page", context: Optional[Any] = None)`

direction : スクロールする方向（'up'、'down'、'left'、'right'）
amount : スクロールする量（「page」、「half」、または数値）
context : オプションのコンテキストオブジェクト（現在は未使用）

`wait_for_navigation(timeout_ms: int = 10000, context: Optional[Any] = None)`

timeout_ms : 最大待機時間（ミリ秒）
context : オプションのコンテキストオブジェクト（現在は未使用）

`execute_javascript(script: str, context: Optional[Any] = None)`

script : 実行するJavaScriptコード
context : オプションのコンテキストオブジェクト（現在は未使用）

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

開発セットアップ

# Clone the repository
git clone https://github.com/random-robbie/mcp-web-browser.git

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

# Install dependencies
pip install -e .[dev]

📄 ライセンス

MITライセンス

🔗 関連プロジェクト

💬 サポート

問題や質問については、GitHub で問題を開いてください。

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

安全な API を介してヘッドレスブラウザーインタラクションを可能にする高度な Web ブラウジングサーバーで、ナビゲーション、コンテンツの抽出、要素のインタラクション、スクリーンショットのキャプチャなどの機能を提供します。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Browser Use Server
ztobs
A
security
F
license
A
quality
Enables browser automation using Python scripts, offering operations like taking webpage screenshots, retrieving HTML content, and executing JavaScript.
Last updated -
4
18
Python
Puppeteer MCP Server
merajmehrabi
A
security
A
license
A
quality
Enables browser automation with Puppeteer, supporting navigation, form interactions, and connection to active Chrome instances for comprehensive web page interaction.
Last updated -
8
470
8
TypeScript
MIT License
WASM MCP Server
beekmarks
-
security
F
license
-
quality
This server enables running a Model Context Protocol in a web browser with functionalities including arithmetic operations and session-based key-value storage.
Last updated -
2
TypeScript
BrowserCat MCP Server (Browser Automation)official
browsercat
-
security
F
license
-
quality
A Model Context Protocol server that provides browser automation capabilities using BrowserCat's cloud browser service. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment without needing to install browsers locally.
Last updated -
39

View all related MCP servers