MCP Py Sse Browser Control

🚀 瀏覽器 JavaScript 執行器

本項目提供了一種在 Python 中藉助 MCP（模型控制協議），於瀏覽器執行 JavaScript 代碼的解決方案，為開發者提供了便捷的跨語言執行能力。

⚠️ 重要提示

此 MCP 服務器能夠在您的瀏覽器中執行任意 JavaScript 代碼，這可能存在安全風險。請在充分了解其潛在影響後再使用此插件，並自行承擔相關風險。

🚀 快速開始

將 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 服務器提供了以下兩個實用工具：

1. execute_javascript：可在瀏覽器中執行任意 JavaScript 代碼。
2. add_numbers：利用瀏覽器中的 JavaScript 對兩個數字進行相加操作。

這些工具可從任何 MCP 客戶端調用。

✨ 主要特性

• 藉助 MCP 協議，實現了在 Python 環境中於瀏覽器執行 JavaScript 代碼的功能。
• 採用 Server-Sent 事件 (SSE) 進行瀏覽器與服務器的連接，確保數據的即時同步。
• 提供 REST API 端點，方便調用和執行 JavaScript 代碼。

🔧 技術細節

架構

項目主要由以下兩個組件構成：

1. Web Server (web_server.py)：
   • 負責處理瀏覽器通過 Server-Sent 事件 (SSE) 的連接，確保數據的即時傳輸。
   • 提供 REST API 端點，用於接收和執行 JavaScript 代碼。
   • 同步返回代碼執行結果，保證數據的一致性。
2. MCP 服務器 (mcp_server.py)：
   • 管理 Web 服務器的生命週期，確保其穩定運行。
   • 提供 MCP 工具，方便在瀏覽器中執行 JavaScript 代碼。
   • 通過 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 服務器將最終結果返回給調用者。

💻 使用示例

基礎用法

若要獨立運行 Web 服務器（用於測試），可執行以下命令：

python web_server.py

此命令將啟動僅包含 Web 服務器而不帶 MCP 集成的服務。