Skip to main content
Glama
zhouweico

mcp-kubevela

by zhouweico

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_HOSTNoHTTP transport listen address0.0.0.0
MCP_PORTNoHTTP transport listen port8080
VELA_URLNoVelaUX API Server addresshttp://localhost:8000
VELA_TIMEOUTNoRequest timeout in seconds30
MCP_LOG_LEVELNoLog level: debug, info, warning, errorinfo
MCP_TRANSPORTNoTransport protocol: stdio, sse, streamable-httpstdio
VELA_PASSWORDYesLogin password (required)
VELA_USERNAMEYesLogin username (required)
MCP_AUTH_TOKENNoSet to enable Bearer Token authentication for HTTP
VELA_READ_ONLYNoRead-only mode, excludes write toolsfalse

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
vela_list_applicationsA

列出 KubeVela 应用,支持按项目/环境/交付目标/关键字过滤。

对应 API:GET /api/v1/applications

vela_get_applicationA

查看应用详情(基础信息、策略、环境绑定、资源统计)。

对应 API:GET /api/v1/applications/{appName}

vela_get_app_statusA

查看应用运行状态(全部环境概览或指定环境详情)。

对应 API:GET /api/v1/applications/{app}/status GET /api/v1/applications/{app}/envs/{env}/status

vela_list_componentsA

查看应用的组件列表;指定 component 时返回组件详情(properties、traits、definition)。

对应 API:GET /api/v1/applications/{app}/components[/{comp}]

vela_list_revisionsA

查看应用版本(revision)历史,可用于回滚前确认目标版本。

对应 API:GET /api/v1/applications/{app}/revisions

vela_list_deploy_recordsB

查看应用在指定环境的部署记录。

对应 API:GET /api/v1/applications/{app}/envs/{env}/records

vela_list_workflow_recordsA

三合一查询:不填 workflow_name 列出工作流;填 workflow_name 列出执行记录; 再填 record 返回该次执行详情(含各步骤状态,可据此取日志)。

对应 API:GET /api/v1/applications/{app}/workflows[/{wf}/records[/{record}]]

vela_get_workflow_logsA

查看工作流执行记录中某个步骤的日志(step 必填,步骤名可先查记录详情获取)。

对应 API:GET .../workflows/{wf}/records/{record}/logs?step=

vela_list_envsB

列出环境(env)及其关联的交付目标。

对应 API:GET /api/v1/envs

vela_list_targetsC

列出交付目标(target,即集群+命名空间组合)。

对应 API:GET /api/v1/targets

vela_list_clustersA

列出纳管集群;指定 cluster_name 时返回集群详情(含资源信息)。

对应 API:GET /api/v1/clusters[/{clusterName}]

vela_list_addonsA

查看插件(addon)市场列表 / 已启用插件 / 单个插件详情与状态。

对应 API:GET /api/v1/addons[...]、GET /api/v1/enabled_addon

vela_list_definitionsA

查看组件/运维特征/策略/工作流步骤定义;指定 definition_name 返回参数 schema。

对应 API:GET /api/v1/definitions[/{name}]?type=

vela_velaql_queryA

执行 VelaQL 查询(Pod 列表、容器日志、资源拓扑等运行时数据)。

对应 API:GET /api/v1/query?velaql= 常用视图:component-pod-view、component-service-view、collect-logs、service-view

vela_system_infoA

查看 VelaUX 平台系统信息:KubeVela 版本、登录方式、集群/应用统计、已启用插件等。

适合作为接入新环境后的连通性与版本自检。 对应 API:GET /api/v1/system_info

vela_compare_applicationA

对比应用配置差异(诊断配置漂移)。三种模式:

  • 仅传 env:最新配置 vs 该环境集群运行态

  • 传 revision + compare_with=running:指定版本 vs 集群运行态

  • 传 revision + compare_with=latest:指定版本 vs 最新配置

对应 API:POST /api/v1/applications/{app}/compare

vela_get_application_manifestA

导出应用的 Application CR YAML 清单(GitOps 迁移 / 备份 / 审计用)。

source=latest 导出最新渲染配置;source=running 导出集群中实际运行的 CR。 基于 compare 接口的 YAML 字段实现。 对应 API:POST /api/v1/applications/{app}/compare

vela_list_triggersA

列出应用的 webhook 触发器(含 token,可拼接触发地址)。

对应 API:GET /api/v1/applications/{app}/triggers

vela_list_projectsA

列出平台中的项目(project),创建应用前用于确认可选项目。

对应 API:GET /api/v1/projects

vela_list_project_targetsA

列出指定项目可用的交付目标(target),部署前确认目标合法性。

对应 API:GET /api/v1/projects/{projectName}/targets

vela_list_project_usersA

列出指定项目的成员及其角色,用于排查权限(403)类问题。

对应 API:GET /api/v1/projects/{projectName}/users

vela_create_applicationA

创建应用(含首个组件),可同时绑定环境。

对应 API:POST /api/v1/applications

vela_deploy_applicationA

触发应用部署工作流(异步)。返回执行记录名,可用 vela_list_workflow_records 跟踪进度。

对应 API:POST /api/v1/applications/{app}/deploy

vela_dry_run_applicationA

部署预演:渲染出将要下发的 K8s 资源 YAML,但不实际部署(安全)。

对应 API:POST /api/v1/applications/{app}/dry-run

vela_rollback_applicationA

回滚应用到指定历史版本(危险操作,需 confirm=true)。

对应 API:POST /api/v1/applications/{app}/revisions/{revision}/rollback

vela_resume_workflowA

恢复挂起(suspend)的工作流,常用于人工审批后继续发布。

对应 API:GET .../records/{record}/resume

vela_terminate_workflowA

终止执行中的工作流(危险操作,需 confirm=true)。

对应 API:GET .../records/{record}/terminate

vela_create_triggerA

创建应用的 webhook 触发器,payload_type 支持 custom / dockerhub / acr / harbor / jfrog,返回 token。

对应 API:POST /api/v1/applications/{app}/triggers

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhouweico/mcp-kubevela'

If you have feedback or need assistance with the MCP directory API, please join our Discord server