obscura-mcp

Адаптер MCP-сервера для Obscura, легковесного headless-браузера на Rust для парсинга и автоматизации AI-агентов.

Предоставляет доступ к нативным возможностям CDP Obscura через чистый интерфейс MCP — без зависимости от Chrome и тяжеловесной автоматизации браузера.

Установка

npm install -g obscura-mcp

Установка происходит мгновенно — бинарный файл браузера (~80 МБ) загружается по требованию при первом использовании.

После установки вы можете:

• Запустить obscura-mcp install для загрузки бинарного файла с отображением прогресса, или

• Просто запустить obscura-mcp — он автоматически загрузит бинарный файл и запустит сервер.

Бинарный файл кэшируется в ~/.obscura/bin/ и сохраняется при обновлениях npm.

Чтобы использовать собственный путь к бинарному файлу:

export OBSCURA_PATH=/path/to/obscura

Related MCP server: Algonius Browser

Быстрый старт

# Install
npm install -g obscura-mcp

# Verify
obscura-mcp --version

# Download browser binary
obscura-mcp install

# Start MCP server
obscura-mcp --transport stdio

Инструменты

browse_url

Получение содержимого URL с помощью движка CDP Obscura. Возвращает содержимое страницы.

Параметры:

• url (строка, обязательно): HTTP или HTTPS URL для посещения.

• dump (строка, опционально): html, text или links. По умолчанию html.

• cookies (массив, опционально): Файлы cookie для внедрения перед навигацией. Принимает тот же формат, что возвращается browse_cookies — используйте cookie, экспортированные из реального браузера, для доступа к страницам с авторизацией.

• stealth (логическое, опционально): Принимается для совместимости. Скрытный режим (stealth) управляется сервером Obscura.

browse_evaluate

Переход по URL и выполнение JavaScript в контексте страницы. Возвращает результат выполнения.

Параметры:

• url (строка, обязательно): URL для посещения.

• expression (строка, обязательно): JavaScript-выражение для выполнения. Примеры: document.title, navigator.userAgent, document.querySelector('h1').textContent.

• stealth (логическое, опционально): Принимается для совместимости.

browse_cookies

Переход по URL и получение всех файлов cookie, установленных страницей. Возвращает имя, значение, домен, путь и срок действия для каждого cookie.

Параметры:

• url (строка, обязательно): URL для посещения.

• stealth (логическое, опционально): Принимается для совместимости.

Конфигурация

Claude Desktop / Cline / Continue / Любой MCP-клиент

{
  "mcpServers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

VS Code (расширение Cline)

{
  "servers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

После глобальной установки через npm, obscura-mcp будет доступен в вашем PATH — абсолютные пути не требуются.

Переменные окружения

Почему Obscura?

• Без Chrome — чистый Rust, никакого 200 МБ пакета браузера

• CDP-native — прямой доступ к протоколу Chrome DevTools

• Анти-детектирование — встроенный скрытный режим для сайтов, защищенных от парсинга

• Минимальный размер — бинарный файл ~15 МБ, запуск за миллисекунды

Лицензия

MIT