WeaveTab MCP V2

Локальный MCP-сервер браузера с нулевой настройкой для ИИ-агентов

npm version License: MIT Socket Badge

WeaveTab — это легковесный локальный сервер Model Context Protocol (MCP), который позволяет ИИ-агентам беспрепятственно взаимодействовать с веб-браузерами с помощью протокола Chrome DevTools Protocol (CDP). В отличие от других решений, WeaveTab полностью автономен и не требует настройки. Он автоматически запускает изолированный профиль браузера параллельно с вашим обычным браузером — это означает, что вам больше никогда не придется закрывать браузер или возиться с портами отладки.

🌟 Ключевые особенности

Автономный браузер с нулевой настройкой: Работает полностью параллельно с вашим существующим браузером через изолированную «песочницу». Никакой ручной настройки портов, не нужно закрывать личный браузер.
Расширения не требуются: Подключается напрямую через нативный CDP.
Семантическая карта действий: weave_read возвращает проанализированную, сильно сжатую семантическую карту DOM, что значительно снижает потребление токенов.
Действия в режиме Sniper: weave_click и weave_type автоматически находят элементы и взаимодействуют с ними за один шаг на основе их намерения или метки.
Локально и безопасно: Никаких зависимостей от облака. Встроенное ограничение частоты запросов и опциональный «Безопасный режим» (Safe Mode).
Поддержка скриншотов: Опционально используйте weave_screenshot для захвата текущих вкладок или weave_peek для целевого визуального анализа конкретных элементов/холста.

🚀 Быстрый старт (Интеграция MCP)

Самый простой способ использовать WeaveTab — через npx. Добавьте следующее в конфигурацию вашего MCP-клиента (например, Cursor, OpenCode, Claude Desktop).

Cursor / OpenCode

Добавьте это в настройки конфигурации MCP вашей IDE:

{
  "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 предоставляет богатый набор специализированных инструментов для вашего ИИ:

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
}

Функции безопасности

Жесткая блокировка хранилища: Отключает скрипты, обращающиеся к cookies/localStorage в определенных средах.
Обнаружение Root: Завершает работу, если запущен с правами суперпользователя.
Белый список доменов: Предотвращает переход агента на ненадежные сайты, когда активен safeMode.
Аудит-логирование: Каждое действие, предпринятое ИИ, чисто логируется локально в ~/.weavetab/audit.log для вашего ознакомления.

🤝 Участие в разработке

Мы приветствуем любой вклад!

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

📄 Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

WeaveTab-MCP