使用说明
WebMCP
WebMCP 让AI代理控制你的真实浏览器——你的浏览器、你的数据、你的机器。没有云沙盒，没有代理。
它通过以下方式将AI代理（Claude、Cursor、自定义LLM）连接到Chrome扩展程序 模型上下文协议（MCP），让他们像您一样导航、单击、键入和阅读页面。
是什么让WebMCP与众不同
- 真实浏览器 --代理将您的实际Chrome与您的Cookie、会话和登录一起使用
- MCP本地 --基于人工智能工具通信的开放标准
- 隐私第一 --一切都在本地运行，没有任何东西离开你的机器
- 25个自动化工具 --导航、阅读页面、填写表单、管理选项卡等
- 可访问性树 --代理将页面视为具有参考号的结构化元素，而不是原始HTML
- 人类监督 --监控弹出窗口、终止开关、验证码检测
快速开始
1.安装扩展
从安装 Chrome网络商店，或从未包装的地方装载 webagent-extension/ 通过 chrome://extensions.
2.启动MCP服务器
cd webagent-mcp
npm install
npm start # stdio transport (for Claude, Cursor)
# or
npm run dev # SSE transport on port 3000
3.连接你的AI
配置您的AI工具以使用WebMCP服务器。该扩展通过WebSocket自动连接。
项目结构
| 目录 | 目的 |
|---|---|
webagent-extension/ |
Chrome扩展程序（MV3） |
webagent-mcp/ |
MCP服务器+WebSocket网桥 |
webagent-sdk-js/ |
用于web应用程序的JavaScript SDK |
webagent-vscode/ |
VS代码扩展包装器 |
docs/ |
协议规范、集成指南 |
文档
权限
WebMCP需要5个Chrome权限和1个主机权限：
| 许可 | 为什么 |
|---|---|
activeTab |
屏幕截图 |
alarms |
MV3服务工作器保持活动（防止WebSocket断开连接） |
storage |
设置持久性 |
tabs |
选项卡管理和消息传递 |
cookies |
自动化会话管理 |
<all_urls> （主机） |
在任何页面上注入内容脚本以实现DOM自动化 |
