🚀 浏览器 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 代理：
