Stealth Browser MCP

🚀 隐身ブラウザ MCP サーバー

このサーバーは、Playwright と反検出技術を利用して、MCP (モデルコンテキストプロトコル) で隠れブラウザ機能を提供します。MCP クライアントがウェブサイトにアクセスしてスクリーンショットを撮る際に、一般的なロボット検出システムを回避できるようになります。

🚀 クイックスタート

このサーバーは、Playwright と反検出技術を利用して、MCP で隠れブラウザ機能を提供し、MCP クライアントがロボット検出システムを回避してウェブサイトにアクセスできるようにします。

✨ 主な機能

• 隠れモード：puppeteer-extra-plugin-stealth と playwright-extra を使用して、ブラウザのフィンガープリントを変更することで、通常のユーザートラフィックのように見せ、ロボット検出を回避します。
  • WebGL、Canvas、フォント、プラグイン、その他のブラウザフィンガープリント技術を処理します。
• スクリーンショットツール：任意のウェブサイトの全ページまたは特定の要素のスクリーンショットを撮ることができます。
  • ヘッドレスモード（デフォルト）と可視ブラウザモードの両方をサポートします。
• MCP 統合：モデルコンテキストプロトコルを通じてブラウザ機能を提供します。

📦 インストール

# 依存関係のインストール
bun install

💻 使用例

基本的な使用法

# MCP サーバーの起動
bun start

# 開発モード
bun dev

# 利用可能なツールの確認
bun inspect

高度な使用法

screenshot

隠れブラウザを使用してウェブページのスクリーンショットを撮ります。

パラメータ：

• url (文字列、必須)：アクセスする URL アドレス
• fullPage (ブール値、オプション、デフォルトは true)：全ページをキャプチャするかどうか
• selector (文字列、オプション)：CSS セレクター、特定の要素のみをスクリーンショットする場合に使用
• headless (ブール値、オプション、デフォルトは true)：ヘッドレスモードで実行するか、ブラウザ画面を表示するか

🔧 技術詳細

このプロジェクトは以下を使用しています：

• FastMCP で MCP サーバーを実装
• Playwright でブラウザの自動化操作を行う
• playwright-extra でプラグインサポートを提供
• puppeteer-extra-plugin-stealth でロボット検出を回避

このプロジェクトは Bun という高速なワンストップ JavaScript ランタイム環境を使用して構築されています。