qontinui-web-mcp

MCP-сервер (Model Context Protocol) для веб-платформы Qontinui. Позволяет ИИ-ассистентам создавать и управлять конфигурациями визуальной автоматизации через API Qontinui.

Функции

• Управление проектами: создание, чтение, обновление и удаление проектов

• Разработка рабочих процессов: создание и изменение рабочих процессов автоматизации

• Управление состояниями: определение состояний пользовательского интерфейса с помощью идентифицирующих изображений

• Импорт/экспорт конфигурации: полное управление конфигурацией

• Сеансы захвата: запись действий пользователя для обучения рабочих процессов

• Управление выполнением: запуск и мониторинг выполнения автоматизации

Related MCP server: Automatisch MCP Server

Установка

cd qontinui-web-mcp
poetry install

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

Установите переменные окружения для API Qontinui:

# Development (local)
export QONTINUI_API_URL="http://localhost:8000"

# Production (AWS)
export QONTINUI_API_URL="http://qontinui-prod-py.eba-km2u4s23.eu-central-1.elasticbeanstalk.com"

# Authentication (obtain from Qontinui web app)
export QONTINUI_ACCESS_TOKEN="your-jwt-token"
# OR use credentials
export QONTINUI_EMAIL="your-email@example.com"
export QONTINUI_PASSWORD="your-password"

Использование

С Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "qontinui-web": {
      "command": "poetry",
      "args": ["run", "qontinui-web-mcp"],
      "cwd": "/path/to/qontinui-web-mcp",
      "env": {
        "QONTINUI_API_URL": "http://localhost:8000",
        "QONTINUI_EMAIL": "your-email@example.com",
        "QONTINUI_PASSWORD": "your-password"
      }
    }
  }
}

С Claude Code

Добавьте в файл .mcp.json вашего проекта:

{
  "mcpServers": {
    "qontinui-web": {
      "command": "poetry",
      "args": ["run", "qontinui-web-mcp"],
      "cwd": "/path/to/qontinui-web-mcp",
      "env": {
        "QONTINUI_API_URL": "http://localhost:8000"
      }
    }
  }
}

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

Аутентификация

• auth_login — аутентификация с помощью email/пароля

• auth_status — проверка текущего статуса аутентификации

• auth_logout — очистка сохраненных учетных данных

Проекты

• list_projects — список всех доступных проектов

• create_project — создание нового проекта

• get_project — получение сведений о проекте

• update_project — обновление метаданных/конфигурации проекта

• delete_project — удаление проекта

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

• export_configuration — экспорт конфигурации проекта в формате JSON

• import_configuration — импорт конфигурации в проект

• validate_configuration — проверка конфигурации без импорта

Рабочие процессы

• create_workflow — добавление рабочего процесса в проект

• update_workflow — изменение существующего рабочего процесса

• delete_workflow — удаление рабочего процесса из проекта

• list_workflows — список рабочих процессов в проекте

Состояния

• create_state — определение состояния пользовательского интерфейса с помощью идентифицирующих изображений

• update_state — изменение определения состояния

• delete_state — удаление состояния из проекта

• list_states — список состояний в проекте

Изображения

• add_image — добавление изображения шаблона в проект

• list_images — список изображений в проекте

• delete_image — удаление изображения из проекта

Выполнение

• execute_workflow — запуск рабочего процесса на подключенном исполнителе

• get_execution_status — проверка прогресса выполнения

• cancel_execution — остановка запущенного рабочего процесса

Разработка

# Install dependencies
poetry install

# Run tests
poetry run pytest

# Format code
poetry run ruff format src/

# Lint (includes import sorting via the `I` rule)
poetry run ruff check src/

# Type check
poetry run mypy src/

API-эндпоинты

Этот MCP-сервер взаимодействует с бэкенд-API Qontinui:

Лицензия

Лицензировано в соответствии с GNU Affero General Public License v3.0 или более поздней версии (AGPL-3.0-or-later). Полные условия см. в LICENSE.