hcltechaiforce/aiforce-mcwa

AI Force Model Context Protocol Web App (MCWA) 镜像文档

镜像概述

本镜像为AI Force平台提供模型上下文协议Web应用(MCWA)的微前端服务，是AI Force生态中的重要组件，负责交付模型上下文相关的Web应用功能。

核心功能与特性

• 端口暴露：默认暴露3000端口，用于Web应用访问
• 健康检查：实现/check_health端点，支持编排器进行服务健康状态检测
• 弹性重启：支持失败时自动重启策略(on-failure)，提升服务可用性
• 日志管理：通过json-file驱动强制日志轮转，避免日志文件过大

使用场景

• AI Force平台的Web应用部署
• 微前端架构中模型上下文服务的集成
• 需要健康检查和弹性恢复能力的Web服务场景

使用方法与配置说明

基本运行命令

bash
docker run -d -p 3000:3000 --restart on-failure --log-driver json-file your-image-name

参数说明

• 端口映射：-p 3000:3000 将容器3000端口映射到主机3000端口，可根据需求调整主机端口
• 重启策略：--restart on-failure 配置服务在失败时自动重启
• 日志驱动：--log-driver json-file 启用json-file日志驱动，实现日志轮转

健康检查验证

服务启动后，可通过以下命令验证健康检查端点：

bash
curl http://localhost:3000/check_health

成功响应表示服务运行正常。

docker-compose配置示例

yaml
version: '3'
services:
  mcwa-service:
    image: your-image-name
    ports:
      - "3000:3000"
    restart: on-failure
    logging:
      driver: "json-file"
      options:
        max-size: "10m"  # 日志文件最大大小
        max-file: "3"   # 保留日志文件数量