MCP Py Sse Browser Control

🚀 ブラウザ JavaScript 実行器

このプロジェクトは、Python で MCP（モデル制御プロトコル）を使用して、ブラウザから JavaScript コードを実行する方法を提供します。

🚀 クイックスタート

注意事項

⚠️ 重要提示

この MCP サーバーは、ブラウザ内で任意の JavaScript を実行できます。これは危険な場合があります。潜在的な影響を理解した上で、このプラグインを使用してください。自己責任で行ってください。

アーキテクチャ

このプロジェクトは 2 つの主要なコンポーネントに分かれています：

1. Web サーバー (web_server.py):

   • ブラウザからの Server-Sent イベント (SSE) 接続を処理します。
   • JavaScript を実行するための REST API エンドポイントを提供します。
   • 結果を同期的に返します。

2. MCP サーバー (mcp_server.py):

   • Web サーバーのライフサイクルを管理します。
   • ブラウザで JavaScript を実行するための MCP ツールを提供します。
   • REST API 呼び出しを通じて Web サーバーと通信します。

動作原理

1. MCP サーバーは、初期化時に Web サーバーを起動します。
2. ブラウザは SSE を介して Web サーバーに接続します。
3. MCP ツールが呼び出されると、Web サーバーに REST API 呼び出しを行います。
4. Web サーバーは SSE を介して JavaScript コードをブラウザに送信します。
5. ブラウザはコードを実行し、結果を SSE を介して Web サーバーに返します。
6. Web サーバーは結果を MCP サーバーに返します。
7. MCP サーバーは結果を呼び出し元に返します。

使用方法

MCP サーバーを Claude 設定に追加する

...
"browser-js-evaluator": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/this/repo/mcp_py_sse_browser_control",
      "run",
      "browser_server.py"
    ]
  }
...

Claude Desktop を起動すると、この設定により MCP サーバーと Web サーバーが起動します。その後、ブラウザを開き、http://127.0.0.1:8000 にアクセスして Web サーバーに接続します。

MCP ツールの使用

MCP サーバーは以下の 2 つのツールを提供します：

1. execute_javascript: ブラウザ内で任意の JavaScript コードを実行します。
2. add_numbers: ブラウザ内の JavaScript を使用して 2 つの数字を足します。

これらのツールは、任意の MCP クライアントから呼び出すことができます。

開発

Web サーバーを単独で実行する（テスト用）には、以下のコマンドを実行します：

python web_server.py

これにより、MCP 統合なしで Web サーバーのみが起動します。