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 集成的服务。