OctoBrowser MCP Server

English | Русский

English

Description

MCP (Model Context Protocol) server for OctoBrowser automation. This server enables Claude Desktop to interact with OctoBrowser, providing browser automation capabilities through a standardized protocol interface.

Features

• Profile Management: Create, read, update, and delete browser profiles

• Tag Management: Organize profiles with tags

• Proxy Management: Configure and manage proxy settings

• Cookie Import: Import cookies into profiles

• Local Control: Start and stop profiles on local machine

• Active Monitoring: Check currently running profiles

Installation

Manual Installation

1. Clone the repository:

git clone https://github.com/momentum100/octobrowser-mcp-server.git
cd octobrowser-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Configure Claude Desktop by adding the following to your Claude Desktop configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "mcp-octobrowser": {
            "command": "node",
            "args": [
                "C:\\mcp-servers\\mcp-octo-browser\\dist\\index.js"
            ],
            "env": {
                "OCTOBROWSER_API_TOKEN": "YOUR_API_KEY_HERE"
            }
        }
    }
}

5. Replace YOUR_API_KEY_HERE with your actual OctoBrowser API token.

6. Adjust the path in args to match your installation directory.

7. Restart Claude Desktop to apply the configuration.

Requirements

• Node.js 16 or higher

• npm or yarn

• OctoBrowser API token

• Claude Desktop application

Configuration

The server requires the following environment variable:

• OCTOBROWSER_API_TOKEN: Your OctoBrowser API authentication token

Optional environment variables:

• OCTOBROWSER_API_URL: API base URL (default: https://app.octobrowser.net)

• OCTOBROWSER_LOCAL_URL: Local client URL (default: http://localhost:58888)

Available Tools

Profile Management

• octobrowser_get_profiles - Get list of profiles with optional filtering

• octobrowser_get_profile - Get detailed profile information

• octobrowser_create_profile - Create a new browser profile

• octobrowser_update_profile - Update existing profile

• octobrowser_delete_profiles - Delete one or more profiles

• octobrowser_import_cookies - Import cookies into a profile

Tag Management

• octobrowser_get_tags - Get all available tags

• octobrowser_create_tag - Create a new tag

• octobrowser_update_tag - Update tag name

• octobrowser_delete_tag - Delete a tag

Proxy Management

• octobrowser_get_proxies - Get all configured proxies

• octobrowser_create_proxy - Add a new proxy configuration

• octobrowser_update_proxy - Update proxy settings

• octobrowser_delete_proxy - Remove a proxy

Local Profile Control

• octobrowser_get_active_profiles - List currently running profiles

• octobrowser_start_profile - Start a profile (GUI or headless)

• octobrowser_stop_profile - Stop a running profile

API Token

To get your OctoBrowser API token:

1. Log in to your OctoBrowser account

2. Navigate to API settings

3. Generate or copy your API token

Related MCP server: Browser Agent MCP

Russian

Описание

MCP (Model Context Protocol) сервер для автоматизации OctoBrowser. Этот сервер позволяет Claude Desktop взаимодействовать с OctoBrowser, предоставляя возможности автоматизации браузера через стандартизированный интерфейс протокола.

Возможности

• Управление профилями: Создание, чтение, обновление и удаление профилей браузера

• Управление тегами: Организация профилей с помощью тегов

• Управление прокси: Настройка и управление параметрами прокси

• Импорт куки: Импорт куки в профили

• Локальное управление: Запуск и остановка профилей на локальной машине

• Активный мониторинг: Проверка запущенных профилей

Установка

Ручная установка

1. Клонируйте репозиторий:

git clone https://github.com/momentum100/octobrowser-mcp-server.git
cd octobrowser-mcp-server

2. Установите зависимости:

npm install

3. Соберите проект:

npm run build

4. Настройте Claude Desktop, добавив следующую конфигурацию в файл настроек Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "mcp-octobrowser": {
            "command": "node",
            "args": [
                "C:\\mcp-servers\\mcp-octo-browser\\dist\\index.js"
            ],
            "env": {
                "OCTOBROWSER_API_TOKEN": "ВАШ_API_КЛЮЧ"
            }
        }
    }
}

5. Замените ВАШ_API_КЛЮЧ на ваш актуальный токен API OctoBrowser.

6. Измените путь в args в соответствии с вашей директорией установки.

7. Перезапустите Claude Desktop для применения конфигурации.

Требования

• Node.js версии 16 или выше

• npm или yarn

• Токен API OctoBrowser

• Приложение Claude Desktop

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

Сервер требует следующую переменную окружения:

• OCTOBROWSER_API_TOKEN: Ваш токен аутентификации API OctoBrowser

Дополнительные переменные окружения:

• OCTOBROWSER_API_URL: Базовый URL API (по умолчанию: https://app.octobrowser.net)

• OCTOBROWSER_LOCAL_URL: URL локального клиента (по умолчанию: http://localhost:58888)

Доступные инструменты

Управление профилями

• octobrowser_get_profiles - Получить список профилей с опциональной фильтрацией

• octobrowser_get_profile - Получить детальную информацию о профиле

• octobrowser_create_profile - Создать новый профиль браузера

• octobrowser_update_profile - Обновить существующий профиль

• octobrowser_delete_profiles - Удалить один или несколько профилей

• octobrowser_import_cookies - Импортировать куки в профиль

Управление тегами

• octobrowser_get_tags - Получить все доступные теги

• octobrowser_create_tag - Создать новый тег

• octobrowser_update_tag - Обновить название тега

• octobrowser_delete_tag - Удалить тег

Управление прокси

• octobrowser_get_proxies - Получить все настроенные прокси

• octobrowser_create_proxy - Добавить новую конфигурацию прокси

• octobrowser_update_proxy - Обновить настройки прокси

• octobrowser_delete_proxy - Удалить прокси

Локальное управление профилями

• octobrowser_get_active_profiles - Список запущенных профилей

• octobrowser_start_profile - Запустить профиль (GUI или headless)

• octobrowser_stop_profile - Остановить запущенный профиль

API токен

Чтобы получить токен API OctoBrowser:

1. Войдите в свою учетную запись OctoBrowser

2. Перейдите в настройки API

3. Сгенерируйте или скопируйте ваш API токен

Development / Разработка

Project Structure / Структура проекта

mcp-octo-browser/
├── src/
│   └── index.ts        # Main server implementation
├── dist/               # Compiled JavaScript (generated)
├── package.json        # Node.js dependencies
├── tsconfig.json       # TypeScript configuration
└── README.md          # Documentation

Building / Сборка

npm run build

Development Mode / Режим разработки

npm run dev

License

MIT

Support

For issues and questions, please visit: https://github.com/momentum100/octobrowser-mcp-server/issues