用途:该技能面向 Notion Dev Containers MCP 服务器,帮助 AI 智能体管理通过 Podman/Docker 运行的容器化 Notion 服务,涵盖容器状态监控、日志查看与搜索、服务启停重启、镜像重建、容器内命令执行以及整套服务栈的 compose 管理。
主要能力:监控类工具包括 list_services(列出全部服务状态)、service_status(单个服务详情,含健康、端口、资源)、health_check_all(整体健康汇总)、get_resource_usage(CPU 与内存占用)。日志类包括 get_logs(按服务取日志,支持 lines、filter 正则、since 时间过滤)和 search_logs(跨多个服务按正则搜索)。控制类包括 start_service、stop_service、restart_service、rebuild_service(可选 no_cache)。Compose 类包括 compose_up(detach)与 compose_down(volumes)。交互类包括 exec_command、get_env(敏感值自动掩码)、get_ports。
管理的服务:polling(notion-polling,8080)、api(notion-api,8000)、archival-grpc(50051 gRPC)、notion-sync(50054 gRPC)、notion-jit(50055 gRPC)、gateway(8000)、nginx-gateway(80)、redis(6379)、stonepro-service(8080)。
使用方式:先调用 list_services 或 health_check_all 了解现状,再按需执行操作;日志查询建议用正则过滤并限制行数;操作后可用 service_status 验证。可通过环境变量定制行为,如 CONTAINER_RUNTIME(默认 podman)、COMPOSE_CMD、COMPOSE_FILE(默认 podman-compose.yml)、MCP_CONTAINER_CMD_TIMEOUT(10 秒)、MCP_COMPOSE_TIMEOUT(120 秒)。
适用场景:调试服务异常、跨服务排查错误、部署代码变更后重建与重启、整体启停服务栈、排查资源占用问题。
限制与注意:compose_down(volumes: true) 会删除所有持久化数据,需谨慎;rebuild_service 期间服务不可用且耗时较长;compose 操作最长可能等待 120 秒。若提示容器运行时不可用,Windows 上可能需先执行 podman machine start;若 compose 命令找不到,可能需安装 podman-compose(pip install podman-compose)或设置 COMPOSE_CMD=podman compose。get_env 会自动掩码含 password、secret、key、token 的值,但使用 exec_command 时仍需注意避免泄露敏感信息。具体收费、价格与平台支持情况暂未提供。