sulus-web-mcp

Playwright MCP без сохранения состояния для исследования живого веба. Агенты получают три инструмента — browse_page, extract_links, search_page, — каждый из которых открывает URL, извлекает текст и закрывает контекст браузера. Инструментов с кликами, набором текста и входом в систему нет.

Создан для Sulus Agents (MCP-коннекторов ai-phone-system) и остальной экосистемы (Cursor, MCPConnect). Laravel не может запускать Chromium внутри своего процесса; этот сервис — HTTP-MCP, к которому обращаются эти агенты.

Инструменты

Каждый вызов самодостаточен (переход + извлечение). Это соответствует клиенту коннектора ai-phone-system, который отправляет tools/list / tools/call без сессии MCP.

Требования

• Node.js 20+

• Playwright Chromium (npx playwright install chromium после npm install)

Настройка

cd /Users/macbook/Workshop/Sulus.ai/sulus-web-mcp
npm install
npx playwright install chromium
cp .env.example .env
# set MCP_SHARED_SECRET
npm run build

HTTP (агенты, команда, продакшн)

npm run start:http
# or: npm run dev:http

Health: GET /health
MCP: POST /mcp (JSON-RPC, Streamable HTTP)

Логи — одна JSON-строка на каждый просмотр (url origin+path, статус, мс). Тела страниц никогда не логируются.

docker

cp .env.example .env
docker compose up -d --build

Используется официальный образ Playwright (с Chromium). Требуется shm_size: 1gb.

stdio (локальный cursor)

npm run start

.cursor/mcp.json:

{
  "mcpServers": {
    "sulus-web": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/Users/macbook/Workshop/Sulus.ai/sulus-web-mcp"
    }
  }
}

HTTP из Cursor (после деплоя):

{
  "mcpServers": {
    "sulus-web": {
      "url": "https://browse.sulus.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SHARED_SECRET"
      }
    }
  }
}

Подключение агентов ai-phone-system

1. Разверните этот сервис за HTTPS.

2. В MCP Connectors добавьте собственный сервер:

   • URL: https://browse.sulus.ai/mcp

   • Авторизация: Bearer, токен = MCP_SHARED_SECRET

3. Включите коннектор для агента.

HTTP-обработчик отвечает на tools/list и tools/call без initialize / Mcp-Session-Id; именно это отправляет ExternalMcpClientService. Sessionless Streamable HTTP по-прежнему работает для Cursor.

Безопасность

• Только HTTPS (если не задано ALLOW_INSECURE_HTTP=true)

• Блокируетlocalhost, RFC1918, link-dimensions, CGNAT, облачные метаданные-хоsts

• Неполняет DNS-сant и отклоняет ответы с частных образов

• Прерывает запросы на странице к заблокированным ответам

• Каждый вызов создаёт новый контекст браузера — без совместного использования cookie

• Нет инструментов для заполнения форм, кликов и загрузки файлов

Scripts

npm run typecheck
npm test
npm run build