ywleeo/browser-mcp

README excerpt

Browser MCP Browser MCP 是一个本地 MCP server，通过用户真实的 Chrome 会话读取和操作公开页面、 JavaScript 渲染页面及登录态页面。 支持以下能力： - 通用网页内容抽取和长内容分页。 - 在不切走当前页面的后台 Chrome 窗口中，向 Agent 提供网页截图和可操作元素，并继续点击、滚动、输入、按键或选择选项。 - 知乎搜索、问题、回答、文章及邀请回答。 - 小红书搜索、账号发布列表、笔记详情、完整评论、点赞/收藏与图片/视频下载。 - 抖音搜索、视频/图文详情、完整评论、点赞/收藏与图片/视频下载。 - B 站视频搜索、内容 meta、分 P 信息，以及视频或纯音频下载。 - X 帖子搜索及帖子详情。 - Reddit 帖子搜索、帖子详情及评论。 - Google、必应和搜狗网页搜索。 当前版本为 0.11.0 ，版本变更见 CHANGELOG.md。 点赞、收藏、发布、发送、购买、删除等会产生外部影响的最终操作，应在执行前向用户确认。 环境要求 - Python 3.12+ - uv - Google Chrome 安装 下文中的 /path/to/browser-mcp 表示本项目在本机的绝对路径。 升级 源码安装提供 Agent 可直接执行的安全升级命令。先检查版本与仓库状态： 确认可以升级后执行： 升级器只接受设置了 upstream 的 Git 分支，并遵循以下保护规则： - 工作区有未提交或未跟踪文件时拒绝升级。 - 本地与远端分叉时拒绝升级，不创建隐式 merge commit。 - 只使用 git pull --ff-only 更新源码。 - 使用 uv sync --frozen 同步锁定依赖，不修改 uv.lock 。 --apply 成功并返回 restart required: true 后，需要让客户端重新连接 MCP server。Codex 中可开启新任务或重连该 MCP；只有客户端无法单独重连时才需要重启客户端。新 MCP server 启动时会刷新扩展 bundle；已加载的 Chrome 扩展根据 build ID 自动重载，无需重新选择扩展目录。 Agent 不需要猜测项目路径。调用 browser status 后，直接使用返回的 upgrade check command 和 upgrade apply command 即可。wheel 或其他包管理器安装会返回 install mode: "package" ，此时应使用原安装工具升级，而不是修改任意 Git 仓库。 配置 Codex 使用 Codex CLI 添加 MCP server： 对应的 Codex MCP 配置为： 首次添加或修改配置后重启 Codex。连接成功后，即可使用下方列出的 MCP 能力…

Category