Browser Ctl

🚀 浏览器 CTL MCP 服务器

本项目是一个基于 SSE 和 Anthropic 的浏览器控制 MCP 服务器，借助 Python Playwright 搭建。它提供了一系列实用工具，可助力 AI 代理实现对网络浏览器的控制与交互。此简易版本采用 Chrome 浏览器。

✨ 主要特性

已暴露工具

• 执行 JavaScript：可在实时浏览器中执行 JavaScript 代码，借助 Playwright 的评估方法，并返回脚本结果。
• 访问 URL：能够访问目标网址并在实时浏览器中打开。
• 等待延迟：浏览器可随机等待指定时长（在开始和结束时间之间）。
• 关闭浏览器：可关闭已打开的浏览器窗口。
• 打开浏览器：能在实时环境中启动浏览器。
• 截取浏览器屏幕截图：可捕获当前浏览器页面的截图，并以 Base64 格式返回图像数据。

📦 安装指南

前期准备

首先，需要安装 uv 并设置 Python 项目和环境。

• Linux 系统：

curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows 系统：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

克隆仓库

git clone https://github.com/biteval/browser_ctl.git

进入项目目录

cd browser_ctl

创建虚拟环境并激活

uv init
uv venv

• Linux 系统：

source .venv/bin/activate

• Windows 系统：

.venv\Scripts\activate

安装依赖项

• Linux 系统：

uv add "mcp[cli]" httpx playwright

• Windows 系统：

uv add mcp[cli] httpx playwright

下载 Playwright 浏览器二进制文件

python -m playwright install

启动 Browser CTL MCP 服务器

python browser_ctl.py

📚 详细文档

默认日志

此 MCP 服务器默认使用信息日志级别启动：

# 配置日志记录
logging.basicConfig(
    level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s"
)

默认端点

http://127.0.0.1:8001/sse

💡 项目贡献

欢迎贡献！您的专业知识和创意将为该项目带来巨大影响。感谢您的参与！

📺 更多信息

访问我们的 YouTube 频道，了解如何创建 AI 代理：