用途:该 MCP 服务器将 Itential Automation Platform (IAP) 的网络自动化编排能力以工具形式提供给 AI 助手,覆盖设备配置、合规、工作流与生命周期管理等场景。
安装与运行:pip install itential-mcp,入口命令 itential-mcp run;支持 stdio(默认)、SSE、HTTP 传输,需 Python 3.10+,依赖 fastmcp、ipsdk>=0.7.0、python-toon、wsproto,容器镜像 ghcr.io/itential/itential-mcp:latest。
必填环境变量:ITENTIAL_MCP_PLATFORM_HOST、ITENTIAL_MCP_PLATFORM_USER、ITENTIAL_MCP_PLATFORM_PASSWORD;可选变量含 PORT(默认 443)、TIMEOUT(30 秒)、DISABLE_TLS、DISABLE_VERIFY、SERVER_TRANSPORT、LOG_LEVEL、TOOLS_PATH。
主要能力按类别划分:平台健康(get_health)、配置管理器(设备、合规计划、设备组、黄金配置树、清单、模板渲染,共 15 个工具)、运营管理器(工作流与作业,5 个)、自动化工作室(命令模板、模板、项目,12 个)、生命周期管理器(资源模型与实例动作,7 个)、适配器与应用生命周期(各 4 个)、网关管理器(3 个)、集成模型(3 个)、工作流引擎指标(6 个)。支持通过 ITENTIAL_MCP_TOOL_<NAME>_TYPE 动态注册 endpoint/service 工具,并可用 --include-tags / --exclude-tags 按 health、configuration_manager 等标签过滤。
用法要点与限制:名称(工作流、设备、模板、计划)区分大小写;部分资料给出护栏建议,如配置部署前先备份、变更前后跑合规计划、写操作失败不要自动重试;写操作失败需向用户报告错误而非猜测结果。适用场景为网络自动化编排、设备配置与合规审计、黄金配置部署、工作流触发与指标分析等。未在资料中说明的功能、收费、价格与具体平台支持范围暂未提供。