qontinui-web-mcp

MCP-Server (Model Context Protocol) für die Qontinui-Webplattform. Ermöglicht KI-Assistenten das Erstellen und Verwalten von visuellen Automatisierungskonfigurationen über die Qontinui-API.

Funktionen

• Projektmanagement: Projekte erstellen, lesen, aktualisieren und löschen

• Workflow-Entwicklung: Automatisierungs-Workflows erstellen und anpassen

• Zustandsverwaltung: UI-Zustände mit identifizierenden Bildern definieren

• Konfigurations-Import/Export: Vollständige Konfigurationsverwaltung

• Capture-Sitzungen: Benutzeraktionen für das Workflow-Lernen aufzeichnen

• Ausführungssteuerung: Automatisierungsläufe auslösen und überwachen

Related MCP server: Automatisch MCP Server

Installation

cd qontinui-web-mcp
poetry install

Konfiguration

Legen Sie Umgebungsvariablen für die Qontinui-API fest:

# 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"

Verwendung

Mit Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/.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"
      }
    }
  }
}

Mit Claude Code

Fügen Sie dies zur .mcp.json Ihres Projekts hinzu:

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

Verfügbare Tools

Authentifizierung

• auth_login - Authentifizierung mit E-Mail/Passwort

• auth_status - Aktuellen Authentifizierungsstatus prüfen

• auth_logout - Gespeicherte Anmeldedaten löschen

Projekte

• list_projects - Alle zugänglichen Projekte auflisten

• create_project - Ein neues Projekt erstellen

• get_project - Projektdetails abrufen

• update_project - Projekt-Metadaten/-Konfiguration aktualisieren

• delete_project - Ein Projekt löschen

Konfiguration

• export_configuration - Projektkonfiguration als JSON exportieren

• import_configuration - Konfiguration in ein Projekt importieren

• validate_configuration - Konfiguration validieren, ohne sie zu importieren

Workflows

• create_workflow - Workflow zum Projekt hinzufügen

• update_workflow - Bestehenden Workflow ändern

• delete_workflow - Workflow aus dem Projekt entfernen

• list_workflows - Workflows im Projekt auflisten

Zustände

• create_state - UI-Zustand mit identifizierenden Bildern definieren

• update_state - Zustandsdefinition ändern

• delete_state - Zustand aus dem Projekt entfernen

• list_states - Zustände im Projekt auflisten

Bilder

• add_image - Musterbild zum Projekt hinzufügen

• list_images - Bilder im Projekt auflisten

• delete_image - Bild aus dem Projekt entfernen

Ausführung

• execute_workflow - Workflow auf einem verbundenen Runner ausführen

• get_execution_status - Ausführungsfortschritt prüfen

• cancel_execution - Laufenden Workflow stoppen

Entwicklung

# 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-Endpunkte

Dieser MCP-Server kommuniziert mit der Qontinui-Backend-API:

Lizenz

Lizenziert unter der GNU Affero General Public License v3.0 oder später (AGPL-3.0-or-later). Siehe LICENSE für die vollständigen Bedingungen.