qontinui-web-mcp

Qontinui Webプラットフォーム用の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 を参照してください。