MCP Web Browser

🚀 MCP ウェブブラウザサーバ

MCP ウェブブラウザサーバは、強力な機能を備えたウェブブラウザサーバです。Playwright を利用したヘッドレスブラウザ機能や、多スレッド処理、拡張プラグイン機構などを提供し、安全で柔軟なウェブ操作を実現します。

🚀 クイックスタート

📦 インストール

pip install mcp-web-browser[master]

🔧 初期設定

from mcp_web_browser import BrowserManager

# ブラウザマネージャーインスタンスを作成
browser_manager = BrowserManager()

# デフォルトのブラウザインスタンスを起動
browser_manager.start_default_browser()

✨ 主な機能

• ヘッドレスブラウザ対応：Playwright を通じて強力なヘッドレスブラウザ機能を提供し、Chromium、Firefox、WebKit などの主流ブラウザエンジンをサポートします。
• 多スレッド処理：効率的な多スレッドアーキテクチャを内蔵し、複数のウェブリクエストとタスクを同時に処理できます。
• 拡張プラグイン機構：柔軟な拡張プラグインシステムをサポートし、ユーザーが必要に応じてカスタム機能モジュールを作成できます。
• 安全な隔離サンドボックス：各ブラウザインスタンスは独立したサンドボックス環境で実行され、相互に干渉せず、悪意のあるスクリプト攻撃を防ぎます。

💻 使用例

基本的な使用法

# 新しい Chromium ブラウザインスタンスを作成
new_browser = browser_manager.create_browser_instance(engine='chromium')

# 指定の URL にアクセス
new_browser.goto('https://www.example.com')

高度な使用法

# ログインボタンを見つけてクリック
login_button = new_browser.find_element(by=By.CSS_SELECTOR, value='#login-btn')
login_button.click()

# フォーム情報を入力
username_input = new_browser.find_element(by=By.ID, value='username')
password_input = new_browser.find_element(by=By.ID, value='password')
username_input.send_keys('your_username')
password_input.send_keys('your_password')

🔒 セキュリティ機能

• リクエストフィルタリング：ルールベースの URL フィルタリングをサポートし、悪意のあるウェブサイトへのアクセスを防止します。
• スクリプトサンドボックス：ユーザーが提供するすべてのスクリプトは隔離環境で実行され、コアシステムのセキュリティを確保します。
• リソース制限：各ブラウザインスタンスには独立したリソース割り当てがあり、リソースの乱用を防止します。

🛠️ トラブルシューティング

問題解決手順

1. ブラウザログを確認し、詳細なエラー情報を取得します。
2. すべての依存関係が正しくインストールされ、最新バージョンであることを確認します。
3. システムのファイアウォールやセキュリティソフトが必要なポートをブロックしていないか確認します。

よくある質問

• 問題：ブラウザインスタンスを起動できません。
  • 解決方法：十分な権限があることを確認し、関連するサービスプロセスが殺されていないことを確認します。

🚧 拡張開発

プラグインの作成

1. 新しい Python パッケージを作成します。
2. パッケージ内で IBrowserPlugin インターフェースを実装します。
3. プラグインをブラウザマネージャーに登録します。

プラグインコード例

from mcp_web_browser.plugins import IBrowserPlugin

class MyCustomPlugin(IBrowserPlugin):
    def on_before_navigate(self, browser, url):
        print(f"アクセス予定: {url}")

    def on_after_navigate(self, browser, url):
        print(f"アクセス完了: {url}")

🤝 コントリビューションガイド

開発環境のセットアップ

git clone https://github.com/yourusername/mcp-web-browser.git
cd mcp-web-browser
pip install -r requirements.txt

コード提出の規則

1. 各機能ブランチに独立した開発ブランチを作成します。
2. 提出前にすべての単体テストと統合テストを通過させます。
3. 変更内容と理由を詳細に記載した変更ログを提供します。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいています。詳細については LICENSE ファイルを参照してください。

🔗 関連リンク

• MCP プロトコル公式サイト
• Playwright 公式サイト
• Claude デスクトップ版

🆘 サポートとヘルプ

問題が発生した場合は、以下の方法でサポートを求めてください。

• GitHub の問題を提出する：GitHub Issues