mcp-kubevela
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | HTTP transport listen address | 0.0.0.0 |
| MCP_PORT | No | HTTP transport listen port | 8080 |
| VELA_URL | No | VelaUX API Server address | http://localhost:8000 |
| VELA_TIMEOUT | No | Request timeout in seconds | 30 |
| MCP_LOG_LEVEL | No | Log level: debug, info, warning, error | info |
| MCP_TRANSPORT | No | Transport protocol: stdio, sse, streamable-http | stdio |
| VELA_PASSWORD | Yes | Login password (required) | |
| VELA_USERNAME | Yes | Login username (required) | |
| MCP_AUTH_TOKEN | No | Set to enable Bearer Token authentication for HTTP | |
| VELA_READ_ONLY | No | Read-only mode, excludes write tools | false |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 | 对比应用配置差异(诊断配置漂移)。三种模式:
对应 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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