WeaveTab MCP V2

面向 AI 智能体的零配置本地浏览器 MCP

npm version License: MIT Socket Badge

WeaveTab 是一个轻量级的本地模型上下文协议 (MCP) 服务器，使 AI 智能体能够使用 Chrome DevTools Protocol (CDP) 与 Web 浏览器无缝交互。与其他解决方案不同，WeaveTab 是完全自主且零配置的。它会自动启动一个与您日常浏览并行的沙盒浏览器配置文件——这意味着您再也不用关闭浏览器或处理调试端口了。

🌟 核心功能

零配置自主浏览器： 通过隔离的沙盒与您现有的浏览器完全并行运行。无需手动配置端口，无需关闭您的个人浏览器。
无需扩展程序： 直接通过原生 CDP 连接。
语义动作映射： weave_read 返回一个解析后的、高度压缩的 DOM 语义映射，显著降低 Token 消耗。
狙击模式动作： weave_click 和 weave_type 可根据意图或标签自动定位并一步完成元素交互。
本地且安全： 无云端依赖。内置速率限制和可选的安全模式。
截图支持： 可选使用 weave_screenshot 捕获当前标签页，或使用 weave_peek 对特定元素/画布进行针对性视觉识别。

🚀 快速开始 (MCP 集成)

使用 WeaveTab 最简单的方法是通过 npx。将以下内容添加到您的 MCP 客户端配置中（例如 Cursor、OpenCode、Claude Desktop）。

Cursor / OpenCode

将其添加到您 IDE 的 MCP 配置设置中：

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

Claude Desktop

编辑您的 claude_desktop_config.json：

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

🛠️ 工具库

WeaveTab 为您的 AI 提供了丰富的专用工具：

weave_read：读取页面并返回语义动作映射。
weave_click：通过标签、意图或 ID 点击元素。
weave_type：安全地在表单中输入文本。
weave_navigate：导航到目标 URL。
weave_scroll：向上、向下、顶部或底部滚动。
weave_wait：等待特定状态（导航、元素、DOM 稳定性）。
weave_tabs：列出打开的标签页或在它们之间切换。
weave_extract：将可见内容提取为文本或 JSON。
weave_screenshot：捕获当前视图的 PNG 图片。
weave_peek：对特定坐标进行针对性视觉识别。
weave_key：按下物理按键和修饰键。
weave_find：在不提取整个页面的情况下，以语义方式查找元素。

🛡️ 安全与配置

WeaveTab 尊重您的系统。它会主动拒绝以 root/sudo 权限运行。

首次运行时，WeaveTab 会在 ~/.weavetab/config.json 生成一个配置文件：

{
  "safeMode": false,
  "allow": [],
  "rateLimitMs": 1000,
  "preferredBrowser": "google-chrome",
  "persistentProfile": false,
  "screenshot": true,
  "peek": true
}

安全特性

存储硬拦截：在特定环境中禁用访问 Cookie/localStorage 的脚本。
Root 检测：如果以 root 权限运行，则会退出。
域名白名单：当启用 safeMode 时，防止您的智能体访问不受信任的站点。
审计日志：AI 执行的每一个动作都会在本地 ~/.weavetab/audit.log 中清晰记录，供您查阅。

🤝 贡献

欢迎贡献代码！

git clone https://github.com/fy2ne/WeaveTab.git
cd WeaveTab
npm install
npm run build

📄 许可证

本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

WeaveTab-MCP