Qontinui Web MCP Server

qontinui网络mcp

Qontinui web平台的MCP（模型上下文协议）服务器。使人工智能助手能够通过Qontinui API创建和管理视觉自动化配置。

特性

• 项目管理：创建、读取、更新、删除项目
• 工作流开发：构建和修改自动化工作流程
• 状态管理：使用标识图像定义UI状态
• 配置导入/导出：完全配置管理
• 捕获会话：记录用户操作以进行工作流学习
• 执行控制：触发和监控自动化运行

安装

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/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"
      }
    }
  }
}

使用克劳德代码

添加到您的项目 .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通用公共许可证v3.0或更高版本（AGPL-3.0或更高）授权。看 许可证 完整条款。