mcp/testkube Docker Image Overview

mcp/testkube

Testkube MCP Server向AI工具和工作流公开持续测试能力，包括测试编排、执行、故障排除和分析，支持通过模型上下文协议集成测试工作流。

0 次下载activemcp

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

Testkube MCP Server

Testkube MCP Server向AI工具和工作流公开持续测试能力（测试编排、执行、故障排除和分析）。

什么是MCP Server？

MCP信息

属性	详情
Docker镜像	mcp/testkube
作者	kubeshop
仓库	[***]

镜像构建信息

属性	详情
Dockerfile	[***]
Docker镜像构建者	Docker Inc.
Docker Scout健康评分	!Docker Scout Health Score
验证签名	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/testkube --key [***]`
许可证	Other

可用工具（20个）

工具名称	简短描述
`abort_workflow_execution`	中止正在运行的测试工作流执行。
`build_dashboard_url`	为Testkube工作流和执行构建仪表板URL。
`create_workflow`	直接从YAML定义在Testkube中创建新的TestWorkflow。
`fetch_execution_logs`	检索测试工作流执行的完整日志，用于调试和分析。
`get_execution_info`	获取特定测试工作流执行的详细信息，包括状态、时间、结果和配置。
`get_workflow`	检索工作流详细信息，包括执行历史、健康指标和当前状态。
`get_workflow_definition`	获取特定Testkube工作流的YAML定义。
`get_workflow_execution_metrics`	获取特定工作流执行的详细资源消耗指标。
`get_workflow_metrics`	获取测试工作流执行的指标，包括执行统计、健康评分、通过率和性能数据。
`list_agents`	检索当前Testkube组织中所有可用的代理，可用于在run_workflow中指定目标代理。
`list_artifacts`	检索工作流执行期间生成的所有制品。
`list_executions`	列出特定测试工作流的执行，支持过滤和分页选项。
`list_labels`	检索当前Testkube环境中工作流的所有可用标签及其值。
`list_resource_groups`	检索当前Testkube环境中所有可用的资源组。
`list_workflows`	列出Testkube工作流，支持按资源组、选择器、状态等条件过滤。
`lookup_execution_id`	将执行名称解析为对应的执行ID。
`read_artifact`	检索工作流执行中特定制品的内容。
`run_workflow`	运行TestWorkflow，支持可选的配置参数和目标规范。
`update_workflow`	使用新的YAML定义更新Testkube中现有的TestWorkflow。
`wait_for_executions`	等待一系列工作流执行完成（通过、失败或超时）。

工具详情

工具：`abort_workflow_execution`

中止正在运行的测试工作流执行。这将停止执行并将其标记为已中止。使用此工具取消长时间运行或卡住的工作流执行。

参数	类型	描述
`executionId`	`string`	MongoDB格式的唯一执行ID（例如：'67d2cdbc351aecb2720afdf2'）。这是大多数操作特定执行的工具使用的内部标识符。如果只有执行名称，请先使用lookup_execution_id工具获取ID。
`workflowName`	`string`	工作流名称。工作流名称为小写字母数字加连字符（例如：'my-workflow'、'api-tests'）。这在组织内唯一标识TestWorkflow。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`build_dashboard_url`

为Testkube工作流和执行构建仪表板URL。

参数	类型	描述
`resourceType`	`string`	仪表板资源类型：'workflow'或'execution'
`workflowName`	`string`	测试工作流名称
`executionId`	`string` 可选	执行ID（执行URL必需）

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`create_workflow`

直接从YAML定义在Testkube中创建新的TestWorkflow。使用此工具将工作流部署到Testkube平台。创建后工作流立即可执行。

参数	类型	描述
`yaml`	`string`	要在Testkube中创建的TestWorkflow的完整YAML定义。应包含元数据、规范和所有步骤的完整工作流规范。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`fetch_execution_logs`

检索测试工作流执行的完整日志，用于调试和分析。

参数	类型	描述
`executionId`	`string`	MongoDB格式的唯一执行ID（例如：'67d2cdbc351aecb2720afdf2'）。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`get_execution_info`

获取特定测试工作流执行的详细信息，包括状态、时间、结果和配置。

参数	类型	描述
`executionId`	`string`	MongoDB格式的唯一执行ID（例如：'67d2cdbc351aecb2720afdf2'）。这是大多数操作特定执行的工具使用的内部标识符。如果只有执行名称，请先使用lookup_execution_id工具获取ID。
`workflowName`	`string`	工作流名称。工作流名称为小写字母数字加连字符（例如：'my-workflow'、'api-tests'）。这在组织内唯一标识TestWorkflow。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`get_workflow`

检索工作流详细信息，包括执行历史、健康指标和当前状态。返回JSON格式的综合工作流元数据。

参数	类型	描述
`workflowName`	`string`	工作流名称。工作流名称为小写字母数字加连字符（例如：'my-workflow'、'api-tests'）。这在组织内唯一标识TestWorkflow。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`get_workflow_definition`

获取特定Testkube工作流的YAML定义。返回完整的工作流规范，包括所有步骤、配置模式和元数据。

参数	类型	描述
`workflowName`	`string`	工作流名称。工作流名称为小写字母数字加连字符（例如：'my-workflow'、'api-tests'）。这在组织内唯一标识TestWorkflow。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`get_workflow_execution_metrics`

获取特定工作流执行的详细资源消耗指标。返回包含时间戳的CPU、内存、磁盘和网络指标等综合资源使用数据。此工具支持分析和比较不同执行的资源消耗。

参数	类型	描述
`executionId`	`string`	MongoDB格式的唯一执行ID（例如：'67d2cdbc351aecb2720afdf2'）。这是大多数操作特定执行的工具使用的内部标识符。如果只有执行名称，请先使用lookup_execution_id工具获取ID。
`workflowName`	`string`	工作流名称。工作流名称为小写字母数字加连字符（例如：'my-workflow'、'api-tests'）。这在组织内唯一标识TestWorkflow。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`get_workflow_metrics`

获取测试工作流执行的指标，包括执行统计、健康评分、通过率和性能数据。返回用于分析工作流性能和可靠性的综合指标数据。

参数	类型	描述
`workflowName`	`string`	工作流名称。工作流名称为小写字母数字加连字符（例如：'my-workflow'、'api-tests'）。这在组织内唯一标识TestWorkflow。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`list_agents`

检索当前Testkube组织中所有可用的代理，可用于在run_workflow中指定目标代理。返回代理列表，包括其ID、名称、类型、功能、标签和环境信息。这对于发现可用于工作流执行目标的代理非常有用。

参数	类型	描述
`capability`	`string` 可选	按功能过滤（例如：'runner'）
`page`	`string` 可选	页码（默认：0）
`pageSize`	`string` 可选	每页项目数（默认：20）
`type`	`string` 可选	按代理类型过滤（例如：'runner'）

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`list_artifacts`

检索工作流执行期间生成的所有制品。使用此工具发现测试运行产生的可用输出、报告、日志或其他文件。这些制品为理解测试结果、访问详细报告或检查生成的数据提供了有价值的上下文。响应包括制品名称、大小和当前状态。

参数	类型	描述
`executionId`	`string`	MongoDB格式的唯一执行ID（例如：'67d2cdbc351aecb2720afdf2'）。这是大多数操作特定执行的工具使用的内部标识符。如果只有执行名称，请先使用lookup_execution_id工具获取ID。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`list_executions`

列出特定测试工作流的执行，支持过滤和分页选项。返回包含状态、时间和结果的执行摘要。

参数	类型	描述
`workflowName`	`string`	工作流名称。工作流名称为小写字母数字加连字符（例如：'my-workflow'、'api-tests'）。这在组织内唯一标识TestWorkflow。
`page`	`string` 可选	分页页码（默认：0）
`pageSize`	`string` 可选	每页返回项目数（默认：10，最大：100）
`status`	`string` 可选	按执行状态过滤。可用状态：'queued'、'running'、'passed'、'failed'、'skipped'、'aborted'、'timeout'、'paused'
`textSearch`	`string` 可选	名称或描述的文本搜索过滤器。可使用空格分隔的词语查找包含所有术语的项目

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`list_labels`

检索当前Testkube环境中工作流的所有可用标签及其值。返回一个映射，其中每个键是标签名称，值是该标签的所有可能值的数组。这对于发现存在哪些标签以及在其他工具中使用选择器过滤时可以使用哪些值非常有用。

工具：`list_resource_groups`

检索当前Testkube环境中所有可用的资源组。返回资源组列表，包括其ID、slug、名称、描述和元数据。这对于发现存在哪些资源组以及在其他工具中按资源组过滤时可以使用哪些slug非常有用。

工具：`list_workflows`

列出Testkube工作流，支持按资源组、选择器、状态等条件过滤。返回工作流名称（也是工作流ID）、描述和执行状态。

参数	类型	描述
`page`	`string` 可选	分页页码（默认：0）
`pageSize`	`string` 可选	每页返回项目数（默认：10，最大：100）
`resourceGroup`	`string` 可选	使用组slug按资源组过滤（例如：'demo-resource-group'、'accounting-tests'）。使用list_resource_groups工具发现可用组
`selector`	`string` 可选	使用key=value格式按标签过滤。单个标签使用'key=value'，多个标签使用逗号分隔格式'key1=value1,key2=value2'。例如：'tool=cypress'或'tool=cypress,env=prod'
`status`	`string` 可选	按执行状态过滤。可用状态：'queued'、'running'、'passed'、'failed'、'skipped'、'aborted'、'timeout'、'paused'
`textSearch`	`string` 可选	名称或描述的文本搜索过滤器。可使用空格分隔的词语查找包含所有术语的项目

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`lookup_execution_id`

将执行名称解析为对应的执行ID。当您有执行名称（例如：'my-workflow-123'、'my-test-987-1'）但需要执行ID时，使用此工具。许多其他工具需要执行ID（MongoDB格式）而不是名称。

参数	类型	描述
`executionName`	`string`	执行名称（例如：'my-workflow-123'）。执行名称遵循工作流名称加数字后缀的模式。当您有执行名称但需要执行ID进行其他操作时使用此参数。

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`read_artifact`

检索工作流执行中特定制品的内容。此工具获取请求文件的最多100行文本内容。

参数	类型	描述
`executionId`	`string`	MongoDB格式的唯一执行ID（例如：'67d2cdbc351aecb2720afdf2'）。这是大多数操作特定执行的工具使用的内部标识符。如果只有执行名称，请先使用lookup_execution_id工具获取ID。
`fileName`	`string`	要检索的制品文件名称

此工具可能执行破坏性更新。

此工具与外部实体交互。

工具：`run_workflow`

运行TestWorkflow，支持可选的配置参数和目标规范。如果工作流需要配置参数，请先使用get_workflow_definition工具检查spec.config部分以查看可用参数。目标参数支持多种格式：1）{"name": "agent-name"}按名称定位特定运行器，2）{"labels": {"env": "prod", "type": "runner"}}按标签定位运行器，3）带有match/not/replicate字段的标准ExecutionTarget格式。

参数	类型	描述
`workflowName`	`string`	工作流名称。工作流名称为小写字母数字加连字符（例如：'my-workflow'、'api-tests'）。这在组织内唯一标识TestWorkflow。
`config`	`object` 可选	工作流的配置参数。请先使用get_workflow_definition工具检查spec.config部分以查看可用参数。
`target`	`object` 可选	多代理执行的目标规范（可选）。支持：{"name": "agent-name"}按名称定位，{"labels": {"env": "prod"}}按标签定位，或带有match/not/replicate字段的标准ExecutionTarget格式。