文档中心

容器服务

请输入

最佳实践

对话即运维：使用 MCP 服务管理您的容器服务集群

容器服务支持通过模型上下文协议（MCP）管理集群中的资源，您可以利用自然语言驱动集群，实现集群资源创建、查询等功能，更便捷高效地进行集群运维。

背景信息

什么是 MCP 协议？

模型上下文协议（Model Context Protocol，MCP）是一种允许大型语言模型（LLMs）访问自定义工具和服务的协议。简单来说，MCP Server（如容器服务 MCP）提供了一系列工具。在 AI IDE（如 Trae、Cursor 等）中，智能体负责根据用户的自然语言指令，调用 MCP Server 提供的工具来执行特定任务。智能体与 MCP Server 的通信依赖 MCP Client 维持。

使用 MCP Server 管理容器服务集群的流程如下：

配置 MCP Server：您需要在 AI IDE 或应用程序中添加容器服务 MCP Server 并配置您的火山引擎账号 API 密钥。

准备 MCP Server 所需本地环境：确保您的本地开发环境已正确安装并配置了运行 MCP Server 所需的组件（如 Node.js、uvx 等，具体依赖于您选择的 MCP Server）。

自然语言交互：通过 AI IDE 的聊天界面，使用自然语言向配置了容器服务 MCP Server 的智能体发出指令（例如：“查询集群中的组件”）。

工具调用与结果返回：智能体解析您的指令，并调用容器服务 MCP Server 提供的相应工具。MCP Server 执行任务后，将结果返回给智能体，最终呈现给您。

功能介绍

容器服务 MCP 是容器服务官方推出的 MCP Server，它允许您通过支持 MCP 协议的 AI IDE 或应用程序，使用自然语言对容器服务集群进行管理。目前，VKE MCP 提供以下核心功能：

功能分类	功能说明
集群管理	CreateCluster：创建容器服务集群。 ListClusters：查询符合条件的集群详情列表。 ListSupportedResourceTypes：查询容器服务支持的周边产品的资源类型列表。 CreateKubeconfig：生成集群的 Kubeconfig 凭证。 ListKubeconfigs：查询符合条件的集群 Kubeconfig 详情列表。
节点池管理	CreateNodePool：在指定集群下创建节点池。 CreateDefaultNodePool：在指定集群下创建默认节点池。 ListNodePools：查询符合条件的节点池信息列表。
节点管理	CreateNodes：在指定集群下添加已有的云服务器（ECS）实例。 ListNodes：查询符合条件的节点列表及信息。 CreateVirtualNode：创建虚拟节点。 ListVirtualNodes：查询符合条件的虚拟节点列表及信息。
组件管理	ListSupportedAddons：查询容器服务当前支持的组件详情列表 CreateAddon：为指定的集群安装组件。 UpdateAddonConfig：更新指定集群下的指定组件配置。 UpdateAddonVersion：更新指定集群下的指定组件版本。 ListAddons：查询符合条件的已安装组件详情列表。
其他	list_k8s_resource：查询集群中特定类型的 Kubernetes 资源。 manage_k8s_resource：管理集群中特定类型的 Kubernetes 资源。 apply_yaml：在集群中执行 apply 操作。

说明

为了防止 AI 智能体出现指令理解错误等导致误删基础设施，暂不支持面向集群资源的删除操作。

前提条件

已创建火山引擎账号，并获取账号的 API 密钥。详情请参见 Access Key（密钥）管理。

说明

为容器服务 MCP 创建账号时，建议遵循以下原则：

专用账户：建议您创建一个 MCP 专用子用户，专门用于 MCP Server 操作。

应用最小权限：请确保您的账号拥有容器服务相关接口的权限（如 CreateCluster、CreateNodePool 等）。并根据权限最小原则，为其授予相应的策略权限。详情请参见配置 IAM 用户权限。

已在本地环境中安装 AI IDE 平台与环境，例如 Trae、Cursor、Cline 等。

已在本地环境中安装以下 MCP Server 所需依赖：

Python：v3.10 及以上版本。您可以访问 Python官网下载并安装。

uv：一个快速的 Python 包安装和管理工具，提供 uvx 命令行工具。详情请参见 uv 官方指引。

部署方式

说明

容器服务 MCP Server 支持本地部署或火山方舟部署，您可以根据需要选择部署方式。

当前仅支持在 Trae 中手动添加容器服务 MCP Server，暂不支持从市场添加。

本地部署

步骤一：部署 MCP Server

本文以在 Trae 平台中为例，简要介绍在 Trae 平台中如何配置和使用容器服务 MCP Server。

在本地环境中登录 Trae 平台。

在 IDE 模式界面中，单击界面右上角的设置图标，进入设置中心。

在顶部导航栏中，选择 MCP，打开 MCP 窗口，单击添加 > 手动添加。

将以下 JSON 配置（请将代码中的YOUR_AK和YOUR_SK替换为您账号实际的 AK 和 SK）粘贴到配置框中。

{
"mcpServers": {
"vke": {
"command": "uvx",
"args": [
"--from",
"git+https@github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vke",
"mcp-server-vke"
],
"env": {
"VOLCENGINE_ACCESS_KEY": "YOUR_AK", // 账号的 AK
"VOLCENGINE_SECRET_KEY": "YOUR_SK", // 账号的 SK
"VOLCENGINE_SESSION_TOKEN": "YOUR_ST", // （可选）临时会话令牌
"ALLOW_WRITE": "false" // （可选）是否开启写权限，取值：true（开启）、false（禁用）
}
}
}
}

环境变量	描述	是否必选
VOLCENGINE_ACCESS_KEY	您火山引擎账号的 AccessKey ID（AK）。获取方式，请参见访问密钥使用指南。	是
VOLCENGINE_SECRET_KEY	您火山引擎账号的 Secret Access Key（SK）。获取方式，请参见访问密钥使用指南。	是
VOLCENGINE_SESSION_TOKEN	临时会话令牌。	否
ALLOW_WRITE	是否开启写权限，取值： true：开启写权限，允许创建、更新操作。 false：（默认值）禁用写权限，不允许创建、更新操作。注意建议仅在必要时开启写权限，避免操作失误导致数据丢失。	否

单击确认，保存配置。

步骤二：关联智能体（Agent）

配置好 MCP Server 后，您需要将其关联到一个智能体，才能通过该智能体使用容器服务 MCP 服务提供的工具。

在设置中心顶部导航栏中选择智能体，创建或编辑智能体。

在工具 - MCP 配置项中，勾选已配置的容器服务 MCP Server。

单击创建，完成配置。

火山方舟部署

访问 MCP MarketPlace。

在服务列表中检索并选择 VKE MCP，单击服务卡片，进入服务详情。

选择安装页签，指定调用工具后，单击生成获取 MCP URL。

使用基础 MCP 工具进行调用，对容器服务集群进行管理。调用方式，请参见云部署 MCP / Remote MCP。

结果验证

交互流程

完成上述配置后，您就可以与关联了容器服务 MCP Server 的智能体进行交互，并完成集群管理操作。

打开与该智能体的聊天窗口。

输入自然语言指令，例如：“检查节点状态”、“查询组件状态”。

智能体接收到指令后，会分析并判断需要使用容器服务 MCP Server 中提供的具体工具。

智能体会自动构建 API 请求参数，并通过 MCP 协议调用容器服务 MCP Server 提供的工具。

MCP Server 执行查询后，将结果返回给智能体。

智能体将结果整理后，以易于理解的方式（如图表、文字描述等）呈现给您。

示例 1：创建集群

使用如下 Prompt 创建一个集群：

预期结果如下：

示例 2：查询集群中的组件

使用如下 Prompt 查询指定集群中已安装的组件：

预期结果如下：

最近更新时间：2026.10.23 10:37:21

这个页面对您有帮助吗？

有用

无用