qontinui-web-mcp

Qontinui 웹 플랫폼을 위한 MCP(Model Context Protocol) 서버입니다. AI 어시스턴트가 Qontinui API를 통해 시각적 자동화 구성을 생성하고 관리할 수 있도록 합니다.

기능

• 프로젝트 관리: 프로젝트 생성, 읽기, 업데이트, 삭제

• 워크플로우 개발: 자동화 워크플로우 구축 및 수정

• 상태 관리: 식별 이미지를 사용하여 UI 상태 정의

• 구성 가져오기/내보내기: 전체 구성 관리

• 캡처 세션: 워크플로우 학습을 위한 사용자 작업 기록

• 실행 제어: 자동화 실행 트리거 및 모니터링

Related MCP server: Automatisch MCP Server

설치

cd qontinui-web-mcp
poetry install

구성

Qontinui API에 대한 환경 변수를 설정합니다:

# 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 - 이메일/비밀번호로 인증

• 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 - 식별 이미지를 사용하여 UI 상태 정의

• 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 서버는 Qontinui 백엔드 API와 통신합니다:

라이선스

GNU Affero General Public License v3.0 이상(AGPL-3.0-or-later)에 따라 라이선스가 부여됩니다. 전체 약관은 LICENSE를 참조하십시오.