自动化配置管理服务器

Qontinui平台的MCP服务器,通过API实现AI助手创建和管理视觉自动化配置。

  • by qontinui
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 qontinui/qontinui-web-mcp

使用说明

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通信:

环境 URL
发展 http://localhost:8000
生产 http://qontinui-prod-py.eba-km2u4s23.eu-central-1.elasticbeanstalk.com

许可证

根据GNU Affero通用公共许可证v3.0或更高版本(AGPL-3.0或更高)授权。看 许可证 完整条款。