热门搜索:
mcp/testkube
Testkube MCP Server向AI工具和工作流公开持续测试能力，包括测试编排、执行、故障排除和分析，支持通过模型上下文协议集成测试工作流。
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Testkube MCP Server
Testkube MCP Server向AI工具和工作流公开持续测试能力（测试编排、执行、故障排除和分析）。
什么是MCP Server？
MCP信息
| 属性 | 详情 |
|---|---|
| Docker镜像 | https://hub.docker.com/repository/docker/mcp/testkube |
| 作者 | https://github.com/kubeshop |
| 仓库 | https://github.com/kubeshop/testkube |
镜像构建信息
| 属性 | 详情 |
|---|---|
| Dockerfile | https://github.com/kubeshop/testkube/blob/6da58c790ecffdec93de52f6bcd671317a7e2f5c/build/mcp-server/Dockerfile |
| Docker镜像构建者 | Docker Inc. |
| Docker Scout健康评分 | !Docker Scout Health Score |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/testkube --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| 许可证 | 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格式。 |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：**`
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull mcp/testkube:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"