文档中心

托管 Prometheus

智能运维

对话即运维：基于MCP服务管理VMP

本文主要介绍如何部署 VMP MCP Server，并在其上使用 VMP 相关功能。

本文档可能包含第三方产品信息，该信息仅供参考。火山引擎平台对第三方产品的性能、可靠性以及操作可能带来的潜在影响，不做任何暗示或其他形式的承诺。

操作场景

您可借助 VMP MCP Server，帮助运维人员在故障排查、数据分析等场景中，实现基于自然语言驱动的指标查询与分析，提升运维观测效率。支持：

创建指定地域下的 VMP 工作区实例。

查询当前账户下指定地域的所有工作区信息。

查询当前账户下指定地域的所有工作区信息。

删除当前账户下指定地域的指定工作区实例。

删除当前账户下指定地域的指定工作区实例。

在指定的 VMP 工作区中，执行指定的 PromQL 的 Instant 查询。

在指定的 VMP 工作区中，执行指定时间范围的 PromQL 的查询。

查询指定 VMP 工作区下，匹配指定过滤条件的指标名称列表。

查询指定 VMP 工作区下，指定指标的所有标签名称列表。

指定标签选择器的时间序列元数据。

背景信息

什么是 MCP 协议？

模型上下文协议（Model Context Protocol，MCP）是一套开放协议，专为大型语言模型（ LLMs ）访问自定义工具与服务设计。简单来说，MCP Server（例如 VMP MCP Server ）会封装并提供各类可执行工具，在 Trae 、Cursor 等 AI IDE 中，智能体会解析用户的自然语言指令，通过 MCP Client 与 MCP Server 建立通信，调用对应工具完成特定任务。

VMP接入MCP能做什么？

MCP 服务作为大语言模型与 VMP 的专属连接纽带，能解锁自然语言驱动的 VMP 智能管理模式。即使为不掌握 PromQL 的运维或业务人员，也可轻松实现 VMP 工作区查询、指标调取等操作，还能让 AI 安全高效地完成跨场景的资源访问与交互，大幅降低 VMP 使用门槛。

前提条件

您已创建火山引擎账号，并获取账号的 API 密钥，了解更多。

说明

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

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

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

操作步骤

步骤一：部署VMP MCP Server

VMP 服务的 MCP Server 支持通过本地和火山方舟两种方式部署，请按需选择。

本地部署

火山方舟部署

通过 AI IDE 工具，在您的本地环境，例如计算机上部署 VMP MCP Server。

前提条件

您已在本地环境完成 AI IDE 平台及相关依赖（ Python 和 uv ）的部署。

工具/插件	说明
AI IDE	本实践将选用 Trae 作为 AI 集成开发环境（AI IDE），开展后续相关操作。 Trae 是一款支持 MCP 协议的 AI IDE，可通过其内置的 MCP 市场或手动配置，快速部署 MCP Server（例如对接 VMP ）。您可以前往 TRAE 官网下载并安装至您的计算机。
Python	v3.10 及以上版本。您可以访问 Python官网下载并安装。
uv	一个快速的 Python 包安装和管理工具，提供 uvx 命令行工具。详情请参见 uv 官方指引。 MacOS/Linux curl -LsSf https://astral.sh/uv/install.sh \| sh Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 \| iex"

操作步骤

步骤一：添加 VMP MCP

将火山引擎大模型生态广场中的 VMP MCP 添加至您的本地 Trae 。

打开您在本地安装的 Trae 平台。

在页面右上角单击设置图标。

在设置页面，选择 MCP。

添加VMP MCP。

手动添加

从市场添加

选择添加 > 手动添加。

将以下 JSON 配置粘贴至配置框，并将代码中的 Your Volcengine access key和 Your Volcengine secret key替换为您账号对应的实际 AK（ Access Key ）与 SK（ Secret Key ）。

{
"mcpServers": {
"mcp_server_vmp": {
"command": "uv",
"env": {
"VOLCENGINE_ACCESS_KEY":"Your Volcengine access key",//火山引擎账号的 AK
"VOLCENGINE_SECRET_KEY":"Your Volcengine secret key"//火山引擎账号的 SK
},
"args": [
"--directory",
"/<your local path to mcp-servers>/server/mcp_server_vmp",
"run",
"mcp-server-vmp"
]
}
}
}

{
"mcpServers": {
"mcp_server_vmp": {
"command": "uvx",
"env": {
"VOLCENGINE_ACCESS_KEY":"Your Volcengine access key",//火山引擎账号的 AK
"VOLCENGINE_SECRET_KEY":"Your Volcengine secret key"//火山引擎账号的 SK
},
"args": [
"--from",
"git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vmp",
"mcp-server-vmp"
]
}
}
}

环境变量

环境变量名	描述	是否必选
VOLCENGINE_ACCESS_KEY	您火山引擎账号的 AccessKey ID（ AK ）。获取方式，请参见访问密钥使用指南。	是
VOLCENGINE_SECRET_KEY	您火山引擎账号的 Secret Access Key（ SK ）。获取方式，请参见访问密钥使用指南。	是
VOLCENGINE_REGION	火山引擎地域	可选